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Preface 


Intended Audience 

This manual is intended for VAX/VMS system managers, operators, and 
system programmers. 


Structure of This Document 

This document is composed of four major sections. 

The Format Section is an overview of SYSGEN and is intended as a quick 
reference guide. The format summary contains the DCL command that 
invokes SYSGEN, listing all commands and options. The usage summary 
describes how to invoke and exit from SYSGEN, how to direct output, and 
any restrictions you should be aware of. 

The Description Section explains how to use SYSGEN. 

The Command Section describes each SYSGEN command. Commands 
appear in alphabetical order. 

The Supplemental SYSGEN Information Section provides complete 
descriptions of SYSGEN parameters. 


Associated Documents 

For additional information on the topics covered in this document, refer to 
the VAX/VMS DCL Dictionary , the Guide to VAX/VMS System Management 
and Daily Operations , the Guide to VAX/VMS Performance Management , and 
the Guide to Writing a Device Driver for VAX/VMS. 


Conventions Used in This Document 


Convention 



$ SHOW TIME 
05-JUN-1985 11:55:22 

$ TYPE MYFILE.DAT 


Meaning 

A symbol with a one- to three-character 
abbreviation indicates that you press a key 
on the terminal, for example, I ret| . 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

Vertical series of periods, or ellipsis, mean 
either that not all the data that the system 
would display in response to the particular 
command is shown or that not all the data 
a user would enter is shown. 
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Convention 

Meaning 

file-spec,... 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be 
entered. 

[logical-name] 

Square brackets indicate that the enclosed 
item is optional. (Square brackets are 
not, however, optional in the syntax of a 
directory name in a file specification or in 
the syntax of a substring specification in an 
assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer 
to double quotation marks ("). The term 
apostrophe (') is used to refer to a single 
quotation mark. 
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New and Changed Features 

The System Generation Utility has been extensively revised for Version 4.0. 
This manual provides a complete description of the revised utility. 
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SYSGEN 


SYSGEN 


FORMAT 


usage summary 


The System Generation Utility (SYSGEN) is a system management 
tool that performs system generation. With SYSGEN, you can: 

• Create and modify system parameters 

• Connect devices and load their drivers 

• Create additional paging and swapping files 

• Identify the current site-independent startup command procedure 

• Initialize multiport memory units 


RUN SYS$SYSTEM:SYSGEN 


Command Qualifiers Defaults 

None. None. 

Command Parameters 

None. 


Invoking 

To invoke SYSGEN, enter the command 

RUN SYSSSYSTEM:SYSGEN 

at the DCL command prompt. You can then enter at the SYSGEN > 
prompt any of the SYSGEN commands summarized in Table SGN-1. These 
commands follow the standard rules of grammar as specified in the VAX/VMS 
DCL Dictionary. 

Exiting 

To exit from SYSGEN, enter the SYSGEN command EXIT at the SYSGEN > 
prompt or press CTRL/Z. 

Directing Output 

You can direct output from a SYSGEN session to an output file using the 
SET/OUTPUT command. By default, output is written to SYS$OUTPUT. See 
the SET/OUTPUT command for more information on controlling SYSGEN 
output. 

Privileges/Restrictions 

Although no privileges are needed to invoke SYSGEN, certain SYSGEN 
commands, such as AUTOCONFIGURE, require special privilege. To see 
which privileges are required, refer to the Commands Section. 
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SYSGEN 


commands 


Syntax 

SYSGEN> command [parameter] 


SYSGEN Commands 

AUTOCONFIGURE adapter-spec 
/EXCLUDE=(device-name[,...]) 
/LOG 

/SELECT=(device-name[,... ]) 
CONFIGURE 


/INPUT=file-spec 
/OUTPUT=f ile-spec 
/[NO]RESET 

CONNECT/ADAPTER=adapter-spec 
/CSR=csr-addr 
/CSR_OFFSET=value 
/DRIVERNAME=driver 
/MAXUNITS=max-unit-cnt 
/NUMVEC=vector-cnt 
/SYSIDHIGH=value 
/SYSIDLOW=value 
/VECTOR=vector-addr 
/VECTOR_OFFSET=value 
CONNECT/NOADAPTER 
/DRIVERNAME=driver 
CONNECT CONSOLE 
CREATE file-spec 
/[NOJCONTIGUOUS 
/SIZE=block-count 
DISABLE CHECKS 
ENABLE CHECKS 
EXIT 
HELP 

INSTALL file-spec 
/INPUT=file-spec 
/ OUTPUT=f ile-spec 
/PAGEFILE 
/SWAPFILE 
LOAD file-spec 
MSCP 

/BUFFER=value 
/HOST=value 
/MAXIMUM=value 
/MINIMUM=value 
/PACKETS=value 
/PRIORITY=value 
/TIMEOUT=value 
RELOAD file-spec 
SET/OUTPUT[=] file-spec 
SET parameter-name value 
SET/STARTUP[=] file-spec 
SHARE/CONNECT 

/MAXCEFCLUSTERS=max-cef 

/MAXGBLSECTIONS=max-gbl 

/MAXMAILBOXES=max-mail 
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SYSGEN 


SHARE/INITIALIZE 
/CEFCLUSTERS=cef 
/GBLSECTIONS=gbl 
/MAILBOXES=mail 
/MAXCEFCLUSTERS=max-cef 
/MAXGBLSECTIONS=max-gbl 
/MAXMAILBOXES=max-mail 
/POOLBCOUNT=block-cnt 
/POOLBSIZE=block-size 
/PRQCOUNT=prq-cnt 
SHOW/ADAPTER 
SHOW/CONFIGURATION 
/ADAPTER=nexus 
/COMMAND_FILE 
/OUTPUT=f ile-spec 
SHOW/DEVICE=device-driver 
SHOW/DRI VER=device-driver 
SHOW [parameter] 

/ACP 

/ALL 

/CLUSTER 

/DYNAMIC 

/GEN 

/HEX 

/JOB 

/LGI 

/MAJOR 

/NAMES 

/PQL 

/RMS 

/SCS 

/SPECIAL 

/SYS 

/TTY 

SHOW/STARTUP 

SHOW/UNIBUS 

/ADAPTER[=nexus] 

TERMINAL/ECHO 
USE file-spec 
WRITE file-spec 

Table SGN-1 summarizes SYSGEN commands and functions. 


Table SGIM—1 SYSGEN Command Summary 


Command 

AUTOCONFIGURE 

CONFIGURE 

CONNECT/ADAPTER 

CONNECT/NOADAPTER 


Function 

Automatically connects the devices physically 
attached to the system and loads their drivers 

Requests the UNIBUS device names and outputs 
the set of CSR and vector addresses that 
AUTOCONFIGURE uses 

Connects hardware devices and loads their drivers 
(if they are not already loaded) 

Connects software devices and loads their drivers 
(if they are not already loaded) 
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SYSGEN 



Table SGN-1 (Cont.) SYSGEN Command Summary 


Command 
CONNECT CONSOLE 

CREATE 

DISABLE CHECKS 

ENABLE CHECKS 

EXIT 

HELP 

INSTALL 

LOAD 

MSCP 

RELOAD 

SET/OUTPUT 

SET parameter-name 

SET/STARTUP 

SHARE/CONNECT 

SHARE/INITIALIZE 

SHOW/ADAPTER 

SHOW/CONFIGURATION 

SHOW/DEVICE 
SHOW/DRIVER 
SHOW [parameter] 


SHOW/STARTUP 

SHOW/UNIBUS 

TERMINAL/ECHO 

USE 


Function 


Connects the console block storage device(s) and 
loads its driver 

Creates or extends a paging, swapping, or dump 
file 

Disables range checks on parameter values 
specified in SET commands 

Enables range checks after a DISABLE CHECKS 
command has disabled them 

Terminates SYSGEN 

Provides information on the SYSGEN commands 

Activates a secondary paging or swapping file 

Loads an I/O driver 

Loads and starts the MSCP server 

Loads a new version of an existing I/O driver 

Defines an output file for the session 

Modifies the value of a system generation 
parameter in the SYSGEN work area 

Names the site-independent startup command 
procedure to be associated with a parameter file 
for subsequent bootstrap operations 

Connects a multiport memory unit to the processor 

Initializes a multiport memory unit 

Lists all the nexus numbers and generic names 

Shows devices by name, number of units, nexus 
number, and adapter type, as well as by CSR and 
vector addresses 

Displays information on connected devices and 
loaded drivers 

Displays information on connected devices and 
loaded drivers 

Displays the values of system parameters in the 
SYSGEN work area, plus the default, minimum, and 
maximum values of the parameters and their units 
of measure 

Displays the name of the current site-independent 
startup command procedure 

Displays the addresses in I/O space that can be 
addressed 

Modifies CTRL/C, CTRL/O, CTRL/Y, and CTRL/Z 
echo strings on a system-wide basis 

Initializes the current SYSGEN work area with 
system parameter values and the name of the 
site-independent command procedure 
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SYSGEN 

Description 


Table SGN-1 (Cont.) 

SYSGEN Command Summary 

Command 

Function 

WRITE 

Writes the system parameter values and the name 
of the site-independent command procedure from 
the SYSGEN work area to a parameter file, the 
current system parameter file, the active system, 
or the default list 


DESCRIPTION Many of the SYSGEN commands are specific to particular topics or functions: 

• System parameters—DISABLE, ENABLE, SET, SHOW, USE, and WRITE 

• Devices and device drivers—AUTOCONFIGURE, CONFIGURE, 
CONNECT, LOAD, RELOAD, SHOW/CONFIGURATION, SHOW 
/DEVICE, SHOW/DRIVER, and SHOW/UNIBUS. The SYSGEN device 
table (Table SGN-2) lists the characteristics of all DIGITAL devices 
that SYSGEN configures automatically. For a complete description of 
devices and device drivers, refer to the Guide to Writing a Device Driver for 
VAX/VMS. 

• System files—CREATE and INSTALL 

• Startup command procedure—SET/STARTUP and SHOW/STARTUP 

• Multiport memory—SHARE/CONNECT and SHARE/INITIALIZE 

You can use a subset of the SYSGEN commands during bootstrap operations; 

see the installation instructions for your VAX processor and the Guide to 

VAX/VMS System Management and Daily Operations for more information. 


1 Specifying Values for SYSGEN Qualifiers and Parameters 

Normally, you specify values as an integer, keyword, or file-spec. For 
parameters, integer values must be within the defined maximum and 
minimum values for the parameter unless the SYSGEN command DISABLE 
CHECKS was specified. 

You can specify values for certain SYSGEN qualifiers and parameters in 
hexadecimal or octal radixes, and for others as an ASCII string. To specify a 
value in octal or hexadecimal, prefix the value with %0 or %X, respectively. 
To specify a value in ASCII, enclose the value string in double quotes (" "). 


2 Active and Current Parameter Values 

It is important to understand the terms active and current when they are 
used to refer to system parameters. The term active parameters refers to the 
parameter values the system is actively running with, that is, the values that 
are active at the present time. The only active parameters that can be changed 
on a running system are those that are categorized as dynamic parameters 
(see Section A.l). The term current parameters refers to those values stored on 
disk (SYS$SYSTEM:VAXVMSSYS.PAR) that are used to boot the system. The 
current parameters become the active parameters at each bootstrap operation. 
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SYSGEN 

Description 


When you modify certain active parameters with SYSGEN, you have no 
effect on the values of the current parameters; you merely change the values 
of these parameters while the system is running. The next time you bootstrap 
the system, the old values of the current parameters are established as the 
active parameters. (When you want to change the values of the current 
parameters on disk, you must use the SYSGEN command WRITE CURRENT. 
Furthermore, when you want to change the value of any active parameter 
that is not in the dynamic category, you must not only issue the WRITE 
CURRENT command, but you must also reboot the system to make it active.) 


3 The SYSGEN Device Table 

The SYSGEN device table indicates the following information for each device 
type that SYSGEN configures automatically: 

• The name of the device recognized by VAX/VMS 

• The device controller name 

• The interrupt vector 

• The number of interrupt vectors per controller 

• The vector alignment factor 

• The address of the first device register for each controller recognized by 
SYSGEN (the first register is usually, but not always, the CSR) 

• The number of registers per controller 

• The name of the device driver, and whether it is supported 
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SYSGEN 

Description 


Table SGN-2 SYSGEN Device Table 


Device 

Ctrl 

Vector 

Number of 
Vectors 

Alignment 

CSR/Rank 

Number of 
Registers 

Driver 

Support 

CR 

CRll 

230 



777160 


CRDRIVER 

Yes 

DM 

RK611 

210 



777440 


DMDRIVER 

Yes 

LP 

LP11 

200 



777514 


LPDRIVER 

Yes 



170 



764004 






174 



764014 






270 



764024 






274 



764034 




DL 

RLll 

160 



774400 


DLD RIVER 

Yes 

MS 

TS11 

224 



772520 


TSDRIVER 

Yes 

DY 

RX211 

264 



777170 


DYDRIVER 

Yes 

" 

RB730 

250 



775606 


DQDRIVER 

Yes 

PU 

UDA 

154 



772150 


PUDRIVER 

Yes 

PT 

TU81 

260 



774500 


PUDRIVER 

Yes 

XE 

UNA 

120 



774510 


XEDRIVER 

Yes 

XQ 

QNA 

120 



774440 


XQDRIVER 

Yes 

OM 

DCll 

Float 

2 

8 

774000 


OMDRIVER 

No 


774010 

774020 

774030 


(maximum of 
32 units) 

DD TU58 Float 2 8 776500 DDDRIVER Yes 

776510 

776520 

776530 


(maximum of 
16 units) 

OB DN11 Float 1 4 775200 OBDRIVER No 

775210 

775220 

775230 


(maximum of 
16 units) 


SGN-7 









SYSGEN 

Description 


Table SGN-2 (Cont.) SYSGEN Device Table 


Number of Number of 

Device Ctrl Vector Vectors Alignment CSR/Rank Registers Driver Support 


YM DM1 IB Float 1 4 770500 

770510 

770520 

770530 


YMDRIVER No 


(maximum of 
16 units) 


OA DR11C Float 2 8 767600 

767570 

767520 

767550 


OADRIVER No 


(maximum of 
16 units) 


PR PR611 Float 1 8 772600 

772604 

772610 

772614 


PRDRIVER No 


(maximum of 
8 units) 


PP PP611 Float 1 8 772700 

772704 

772710 

772714 


PPDRIVER No 


(maximum of 
8 units) 

OC DT11 Float 2 8 777420 OCDRIVER No 

777422 

777424 

777426 


(maximum of 
8 units) 

OD DX11 Float 2 8 776200 

776240 


ODDRIVER No 
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SYSGEN 

Description 


Table SGN-2 (Cont.) SYSGEN Device Table 


Device 

Ctrl 

Vector 

Number of 
Vectors 

Alignment 

CSR/Rank 

Number of 
Registers 

Driver 

Support 

YL 

DL11C 

Float 

2 

8 

775610 

775620 

775630 

775640 

(maximum of 
31 units) 


YLDRIVER 

No 

YJ 

DJ11 

Float 

2 

8 

Float 

4 

YJDRIVER 

No 

YH 

DH11 

Float 

2 

8 

Float 

8 

YHDRIVER 

No 

OE 

GT40 

Float 

4 

8 

772000 

772010 


OEDRIVER 

No 

LS 

LPS11 

Float 

6 

8 

770400 


LSDRIVER 

No 

OR 

DQ11 

Float 

2 

8 

Float 

4 

ORDRIVER 

No 

OF 

KW11W 

Float 

2 

8 

772400 


OFDRIVER 

No 

XU 

DUll 

Float 

2 

8 

Float 

4 

XUDRIVER 

No 

xw 

DUPll 

Float 

2 

8 

Float 

4 

OODRIVER 

No 

XV 

DV11 

Float 

3 

8 

775000 

775040 

775100 

775140 


XVDRIVER 

No 

OG 

LK11 

Float 

2 

8 

Float 

4 

OGDRIVER 

No 

XM 

DMCll 

Float 

2 

8 

Float 

4 

XMDRIVER 

Yes 

TT 

DZ11 

Float 

2 

8 

Float 

4 

DZDRIVER 

Yes 

XK 

KMCll 

Float 

2 

8 

Float 

4 

XKDRIVER 

No 

OH 

LPP11 

Float 

2 

8 

Float 

4 

OHDRIVER 

No 

01 

VMV21 

Float 

2 

8 

Float 

4 

OIDRIVER 

No 

OJ 

VMV31 

Float 

2 

8 

Float 

8 

OJDRIVER 

No 

OK 

DWR70 

Float 

2 

8 

Float 

4 

OKDRIVER 

No 

DL 

RL11 

Float 

1 

4 

Float 

4 

DLDRIVER 

Yes 

MS 

TS11 

Float 

1 

4 

772524 

772530 

772534 


TSDRIVER 

Yes 
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Description 


Table SGN-2 (Cont.) SYSGEN Device Table 


Device 

Ctrl 

Vector 

Number of 
Vectors 

Alignment 

CSR/Rank 

Number of 
Registers 

Driver 

Support 

LA 

LPA11 

Float 

2 

8 

770460 


LADRIVER 

Yes 

LA 

LPA11 

Float 

2 

8 

Float 

8 

LADRIVER 

Yes 

OL 

KW11C 

Float 

2 

8 

Float 

4 

OLDRIVER 

No 

RSV 

RSV 

Float 

1 

8 

Float 

4 

RSVDRIVER 

No 

DY 

RX211 

Float 

1 

4 

Float 

4 

DYDRIVER 

Yes 

XA 

DR11W 

Float 

1 

4 

Float 

4 

XADRIVER 

Yes 

XB 

DR11B 

124 



772410 


XBDRIVER 

No 

XB 

DRUB 

Float 

1 

4 

772430 

4 

XBDRIVER 

No 

XB 

DR11B 

Float 

1 

4 

Float 

4 

XBDRIVER 

No 

XD 

DMP11 

Float 

2 

8 

Float 

4 

XDDRIVER 

Yes 

ON 

DPVll 

Float 

2 

8 

Float 

4 

ONDRIVER 

No 

IS 

ISB11 

Float 

2 

8 

Float 

4 

ISDRIVER 

No 

XD 

DMVll 

Float 

2 

8 

Float 

8 

XDDRIVER 

No 

XE 

UNA 

Float 

1 

4 

Float 

4 

XEDRIVER 

No 

PU 

UDA 

Float 

1 

4 

Float 

2 

PUDRIVER 

Yes 

TX 

DMF32 

Float 

8 

4 

Float 

16 

YCDRIVER 

Yes 

XG 







XGDRIVER 

Yes 

LC 







LCDRIVER 

Yes 

XI 







XIDRIVER 

No 

xs 

KMS11 

Float 

3 

8 

Float 

8 

XSDRIVER 

No 

XP 

PCL11 

Float 

2 

8 

764200 


XPDRIVER 

No 






764240 









764300 









764340 




VB 

VS 100 

Float 

1 

4 

Float 

8 

VBDRIVER 

No 

PT 

TU81 

Float 

1 

4 

Float 

2 

PUDRIVER 

Yes 

OQ 

KMV11 

Float 

2 

8 

Float 

8 

OQDRIVER 

No 

UK 

KCT32 

Float 

2 

8 

764400 


UKDRIVER 

No 


764440 

764500 

764540 
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Description 


Table SGN-2 (Cont.) SYSGEN Device Table 


Device 

Ctrl 

Vector 

Number of 
Vectors 

Alignment 

CSR/Rank 

Number of 
Registers 

Driver 

Support 

IX 

IEQ11 

Float 

2 

8 

764100 


IXDRIVER 

No 

TX 

DHV11 

Float 

2 

8 

Float 

8 

YFDRIVER 

Yes 

TX 

DMZ32/ 

CPI32 

Float 

6 

4 

Float 

16 

YCDRIVER 

Yes 

XG 

CPI32 

Float 

6 

4 

Float 

16 

XGDRIVER 

Yes 

DT 

TCll 

214 



777340 


DTDRIVER 

No 

VC 

VC01B 

060 



777200 


VCDRIVER 

Yes 


4 Error Messages 

The VAX/VMS System Messages and Recovery Procedures Reference Manual lists 
the messages generated by SYSGEN and provides explanations and suggested 
user actions. 
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SYSGEN Commands 


SYSGEN This section explains SYSGEN commands and provides examples of their use. 

COMMANDS 
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AUTOCONFIGURE 


AUTOCONFIGURE 



Automatically connects devices that are physically attached to the 
system and loads their drivers. 

Use of the AUTOCONFIGURE command requires the CMKRNL 
privilege. 

FORMAT 

AUTOCONFIGURE adapter-spec 

command 

parameter 

adapter-spec 

Specifies the adapter-spec (backplane interconnect arbitration line) or slot 
number of the single UNIBUS or MASSBUS adapter that is to be configured, 
or the keyword ALL. The adapter-spec can be expressed as an integer or with 
one of the names listed by the SYSGEN command SHOW/ADAPTER. 

command 

qualifiers 

/EXCLUDE=(device-name[,...]) 

Specifies the device type(s) not desired for autoconfiguration. 

Specify a standard device-name as shown in in Table SGN-2 or a device¬ 
type code as shown in Table SGN-3. You may include a controller 
designation, but do not include a unit number. If the controller designation 
is omitted, device-name refers to all devices of the specified type. The device 
name specification defaults to all devices on the adapter. 

Do not use this qualifier with the /SELECT qualifier; they are mutually 
exclusive. 

/LOG 

Produces a display of the controller and its units on the current 
SYS$OUTPUT device after they have been successfully autoconfigured. In 
other words, each controller and its associated units are displayed only after 
AUTOCONFIGURE has found the next controller. Thus, the error message 
displays precede the display of the controller and units that caused the error. 

/SELECT=(device-name[,...]) 

Specifies the device type(s) desired for autoconfiguration. 

Specify a standard device-name as shown in in Table SGN-2 or a device¬ 
type code as shown in Table SGN-3. You may include a controller 
designation, but do not include a unit number. If the controller designation 
is omitted, device-name refers to all devices of the specified type. The 
device-name specification defaults to all devices on the adapter. 

Do not use this qualifier with the /EXCLUDE qualifier; they are mutually 
exclusive. 
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AUTOCONFIGURE 


Table SGN 

—3 Device Type Codes 

Code 

Device Type 

CR 

Card Reader 

CS 

Console Storage Device 

DB 

RP05, RP06 Disk 

DD 

TU58 Cartridge Tape 

DJ 

RA 60 Disk 

DL 

RL02 Cartridge Disk 

DM 

RK06, RK07 Cartridge Disk 

DQ 

RL02 Cartridge Disk, R80 Disk 

DR 

RM03, RM05, RM80, RP07 Disk 

DU 

UDA Disk 

DX 

RX01 Floppy Diskette 

DY 

RX02 Floppy Diskette 

LA 

LPA11-K Laboratory Peripheral Accelerator 

LC 

Line Printer on DMF32 

LP 

Line Printer on LP11 

MB 

Mailbox 

MF 

TU78 Magnetic Tape 

MS 

TS11 Magnetic Tape 

MT 

TE16, TU45, TU77 Magnetic Tape 

MU 

Tape Class Driver 

NET 

Network Communications Logical Device 

NL 

System "Null" Device 

OP 

Operator's Console 

PA 

Computer Interconnect (Cl) 

PT 

TU81 Magnetic Tape 

PU 

UDA-50 

RT 

Remote Terminal 

TT 

Interactive Terminal on DZ11 

TX 

Interactive Terminal on DMF32, DMZ32, or DHU11 

XA 

DR11 —W General Purpose DMA Interface 

XD 

DMP-11 Synchronous Communications Line 

XF 

DR32 Interface Adapter 

XG 

DMF32 Synchronous Communications Line 

XI 

DR Interface on DMF-32 

XJ 

DUP11 Synchronous Communications Line 

XM 

DMC11 Synchronous Communications Line 
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SYSGEN 

AUTOCONFIGURE 


EXAMPLES 

Q SYSGEN> AUTOCONFIGURE ALL 

The command in this example automatically configures all standard devices. 

0 SYSGEN> AUTOCONFIGURE ALL /SELECT=(TT,MTA,LP) 

The command in this example automatically configures all terminals, all 
magnetic tape units on controller A, and all line printers. 

0 SYSGEN> AUTOCONFIGURE ALL /EXCLUDE=XM 

The command in this example illustrates the use of the /EXCLUDE qualifier 
to autoconfigure all but the DMC11 devices, assuming DECnet-VAX will not 
be operating on this system. 


SGN-15 





SYSGEN 

CONFIGURE 


CONFIGURE 



Requests UNIBUS device names and outputs the set of CSR and 
vector addresses that AUTOCONFIGURE will use. 

FORMAT 

CONFIGURE 

command 

parameters 

None. 

command 

qualifiers 

/INPUT=file-spec 

Specifies the name of an input file from which previously prepared data is 
read. By'default, input data is read from SYS$INPUT. 

/OUTPUT=file-spec 

Specifies the name of an output file to which output from CONFIGURE is 
written. By default, output is directed to SYS$OUTPUT. The default file type 
is LIS. 

/[NO]RESET 

Controls whether controller names are reset. The /NORESET qualifier is 
useful with multiple UNIBUS systems. When you specify /NORESET, 
it is not necessary to specify the second parameter (p) on subsequent 
CONFIGURE commands, since the controller names are not reset. By default, 
if you omit /NORESET, the controller names are reset. 

DESCRIPTION 

CONFIGURE prompts with: 

DEVICE> 

Input should be in the form, below, where device is the name of the controller 
from Table SGN-2. 

device[[,n],p] 

The controller names displayed there in the "Ctrl" column are those accepted 
by the CONFIGURE command. You cannot abbreviate controller names. 

You can optionally specify n, the number of devices on the UNIBUS being 
configured, and p, the optional number of devices on all previous UNIBUSes 
in a multiple UNIBUS system. Note that p does not affect the addresses 
generated, only the device names. By default, n is 1 and p is 0. 

SYSGEN continues to prompt for devices until you respond with CTRL/Z. It 
then outputs the CSR and vector addresses. 
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SYSGEN 

CONFIGURE 


EXAMPLE 


SYSGEN> CONFIGURE 
DEVICE> DZ11,3,2 
DEVICE> LP11 
DEVICE> DMC11.2 


DEVICE> 


CTRL/Z 


The system displays the following data: 


Device: 

RK611 

Name: 

DMA 

CSR 

Device: 

LP11 

Name: 

LPA 

CSR 

Device: 

DMC11 

Name: 

XMA 

CSR 

Device: 

DMC11 

Name: 

XMB 

CSR 

Device: 

DZ11 

Name: 

TTC 

CSR 

Device: 

DZ11 

Name: 

TTD 

CSR 

Device: 

DZ11 

Name: 

TTE 

CSR 


* Indicates a floating address 


777440 

Vector: 

210 

Support: 

yes 

777514 

Vector: 

200 

Support: 

yes 

760070* 

Vector: 

300* 

Support: 

yes 

760100* 

Vector: 

310* 

Support: 

yes 

760120* 

Vector: 

320* 

Support: 

yes 

760130* 

Vector: 

330* 

Support: 

yes 

760140* 

Vector: 

340* 

Support: 

yes 


This example illustrates the use of the CONFIGURE command to calculate 
the UNIBUS CSR and vector addresses. The support field in the display 
indicates whether DIGITAL provides a supported driver for this device with 
VAX/VMS. 
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SYSGEN 

CONNECT/ADAPTER=adapter-spec 


CONNECT/ADAPTER=adapter-spec 

Connects a hardware device and loads its driver, if the driver is not 



already loaded. The adapter-spec is the name of the UNIBUS or 
MASSBUS adapter to which the device is attached. The value can 
be expressed as an integer or as one of the names listed by the 
SYSGEN command SHOW/ADAPTER. 

Use of the CONNECT/ADAPTER=adapter-spec command requires 
the CMKRNL privilege. 

FORMAT 

CONNECT/ADAPTER=adapter-spec device 

command 

parameter 

device 

Specifies the name of the hardware device to be connected. It should be 
specified in the form: device-type, controller, unit. For example, LPAO is the 
device name for unit 0 on controller A of device type LP. 

command 

qualifiers 

/CSR=csr-addr 

Specifies the UNIBUS address of the first addressable location on the 
controller (usually the status register) for the device. This qualifier must 
be specified for UNIBUS devices. For devices on multiple device boards (for 
example, the DMF32), the address must be the CSR address specified in the 
output of the CONFIGURE command. To specify the address in octal or 
hexadecimal, prefix the address with %0 or %X, respectively. 

/CSR— OFFSET=value 

For devices on multiple device boards, specifies the offset from the CSR 
address of the multiple device board to the CSR address for the specific 
device being connected. To specify the address in octal or hexadecimal, prefix 
the address with %0 or %X, respectively. 

/DRIVER NAM E=driver 

Specifies the name of the driver as recorded in the prolog table. If the driver 
has not been loaded, the system assumes that the driver name is also the 
name of an executable image (file type of EXE) in SYS$SYSTEM and loads 
the driver. The driver name defaults to the first two characters of the device 
name plus DRIVER. 

/MAXUNITS=max-unit-cnt 

Specifies the maximum number of units the controller can support (that is, 
the number of UCB slots in the IDB). The default is the number specified in 
the prolog table of the driver, or 8 if the number is not specified in the prolog 
table. 

/NUMVEC=vector-cnt 

Specifies the number of interrupt vectors for the device. By default, the vector 
count is 1. 
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SYSGEN 

CONNECT/ADAPTER=adapter-spec 


/SYSIDHIGH=value 

Specifies the high-order 16 bits of the 48-bit system identification number and 
must be 0. To specify the value in octal or hexadecimal, prefix the value with 
%0 or %X, respectively. 

/SYSIDLOW=value 

Specifies the low-order 32 bits of the 48 bit system identification number. 

The value must be identical to the DECnet-VAX node number. To specify the 
value in octal or hexadecimal, prefix the value with %0 or %X, respectively. 

/VECTOR=vector-addr 

Specifies the UNIBUS address of the interrupt vector for the device or the 
lowest vector, if there is more than one. This qualifier must be specified for 
UNIBUS devices. For devices on multiple device boards (for example, the 
DMF32), the address must be the interrupt vector address for the multiple 
device board specified in the output of the CONFIGURE command. To 
specify the address in octal or hexadecimal, prefix the address with %0 or 
%X, respectively. 

/VECTOR— OFFSET=value 

For devices on multiple device boards, specifies the offset from the interrupt 
vector address of the multiple device board to the interrupt vector address 
for the specific device being connected. To specify the address in octal or 
hexadecimal, prefix the address with %0 or %X, respectively. 


DESCRIPTION You normally use this command to connect devices that are not physically 

attached to the system or whose drivers are not standard. 

Caution: You should exercise extreme caution when using the 

CONNECT/ADAPTER=adapter-spec command, because the system 
does little error checking. An incorrect vector address or misspelled 
device name, for example, will damage the I/O data base and very 
likely cause the system to fail. The Guide to Writing a Device Driver for 
VAX/VMS contains more detailed information on loading device drivers 
and connecting devices. 


EXAMPLE 

SYSGEN> CONNECT /ADAPTER=3/CSR=%0777514- 
SYSGEN> /DRIVERNAME=LP2DRIVER/VECT0R='/,0200 LPAO 

The command in this example connects the device named LPAO to the driver 
named LP2DRIVER, and loads the driver if it is not already loaded. 
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CONNECT/NOADAPTER 


CONNECT/NOADAPTER 

Connects a software device and loads its driver if it is not already 



loaded. 

Use of the CONNECT/NOADAPTER command requires the CMKRNL 
privilege. 

FORMAT 

CONNECT/NOADAPTER device 

command 

parameter 

device 

Specifies the name of the software device to be connected. 

command 

qualifier 

/DRIVERI\IAME=driver 

Specifies the name of the driver as recorded in the prolog table. If the driver 
has not been loaded, the system assumes that the driver name is also the 
name of an executable image (file type of EXE) in SYS$SYSTEM, and loads 
the driver. The default is the first two characters of the device name plus 
DRIVER. The driver prolog table must specify ADAPTER=NULL for this 
command to work. 


EXAMPLE 

SYSGEN> CONNECT /NOADAPTER/DRIVER=NETDRIVER NET 

The command in this example connects the device NET to the driver 
NETDRIVER, and loads the driver if it is not already loaded. 
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CONNECT CONSOLE 


CONNECT 

CONSOLE 

The CONNECT CONSOLE command connects the console block 
storage device(s) and loads the driver. The console block storage 
device driver is CSDRIVER.EXE. 

Use of the CONNECT CONSOLE command requires the CMKRNL 
privilege. 

FORMAT 

CONNECTCONSOLE 

command 

parameters 

None . 

command 

qualifiers 

None. 
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CREATE 


CREATE 

Creates or extends a file that can be used as a paging, swapping, or 
dump file. 

FORMAT 

CREATE file-spec 

command 

parameter 

file-spec 

Specifies the name of the paging, swapping, or dump file. The default 
file type is SYS. Primary paging and swapping files have the names 
SYS$SYSTEM:PAGEFILE.SYS and SYS$SYSTEM:SWAPFILE.SYS. 

The dump file name is SYS$SYSTEM:SYSDUMP.DMP. When you create a 
new SYSDUMP.DMP file, you must explicitly specify the file type DMP. 

command 

qualifiers 

/[NOJCONTIGUOUS 

Controls whether CREATE creates a contiguous file. The default is 

/NOCONTIGUOUS, which implies a contiguous-best-try file. If 

/NOCONTIGUOUS is specified, the following logic is used: 

1 If the file does not exist, SYSGEN creates it. 

2 If the file does exist and the size specified by the /SIZE qualifier is smaller 
than the current size, then SYSGEN creates a new file of the new size. 

3 If the file does exist and the size specified by the /SIZE qualifier is larger 
than the current size, then SYSGEN extends the current file to the new 
size. 

The /CONTIGUOUS qualifier forces the creation of a new file and guarantees 

that the file will be contiguous. 

/SIZE=block-count 

Specifies the number of blocks to be allocated to the file when the operation 

is complete. 

DESCRIPTION 

You do not have to issue this command directly for the creation of primary 
files because the installation of VAX/VMS creates them. However, you 
should execute the command procedure SYS$UPDATE:SWAPFILES to change 
the size of the primary files. 

A secondary paging or swapping file only takes effect after you install it 
with the SYSGEN commmand INSTALL. The only way you make a new 
SYSDUMP.DMP file active is by rebooting the system. 

Files created with SYSGEN receive the default protection of the process 
that invoked SYSGEN. Thus, DIGITAL recommends that you use the 
SWAPFILES command procedure, which includes a SET PROTECTION 
command to establish appropriate protection for the files after it creates them 
with SYSGEN. 
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SYSGEN 

CREATE 


EXAMPLES 

Q SYSGEN> CREATE SYS$SYSTEM:PAGEFILE /SIZE=95000 /CONTIGUOUS 

'/.SYSGEN-1-CREATED, SYSSSYSROOT: [SYSEXE] PAGEFILE. SYS; 2 created 

The command in this example creates a contiguous paging file of 95,000 
blocks. 

0 SYSGEN> CREATE SYS$SYSTEM:PAGEFILE /SIZE=100000 

'/.SYSGEN-I-EXTENDED, SYSSSYSROOT: [SYSEXE]PAGEFILE.SYS;2 extended 

The command in this example extends the file created in Example 1 to 
100,000 blocks. 


SGN-23 



SYSGEN 

DISABLE CHECKS 


DISABLE CHECKS 


Inhibits range checks on parameter values specified in SET 
commands. 

FORMAT 

DISABLE CHECKS 

command 

parameters 

None. 

command 

qualifiers 

None. 

DESCRIPTION 

Initially, checks are enabled. If you specify a value above the maximum, the 
system sets the parameter to the maximum and issues an error message. If 
you specify a value below the minimum, the system sets the parameter to the 
minimum and issues an error message. The DISABLE CHECKS command 
allows you to override maximum and minimum values. 

Caution: 

The minimum and maximum values established by DIGITAL are 
intended as fairly strict guidelines. Setting parameter values outside 
these limits can result in system failures or hangs. Thus, the use of 
DISABLE CHECKS is not recommended. 


EXAMPLE 


SYSGEN> SET WSMAX 20 

V.SYSGEN-W-SETMIN, Value set to minimum for parameter WSMAX 
SYSGEN> DISABLE CHECKS 
SYSGEN> SET WSMAX 20 


In this example, the initial attempt to set WSMAX below the minimum fails 
because range checks are enabled. However, once the user disables range 
checks, the SET WSMAX command succeeds. 
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ENABLE CHECKS 


ENABLE CHECKS 



Ensures that range checks are in effect. 

Initially, range checks are enabled; therefore, this command need be 
used only after a DISABLE CHECKS command was issued earlier in 
the session. 

FORMAT 

ENABLE CHECKS 

command 

parameters 

command 

qualifiers 

None. 

None. 


EXAMPLE 

SYSGEN> DISABLE CHECKS 
SYSGEN> SET WSMAX 20 
SYSGEN> ENABLE CHECKS 
SYSGEN> SET WSMAX 30 

'/.SYSGEN-W-SETMIN, Value set to minimum for parameter WSMAX 

This example illustrates the use of the ENABLE CHECKS command to 
reenable parameter value checks. 
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EXIT 


EXIT 



Returns you to command level. You can also return to command 
level by pressing CTRL/Z. 

FORMAT 

EXIT 

command 

parameters 

None. 

command 

qualifiers 

None. 
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HELP 


HELP 

Lists and explains the SYSGEN commands. 

FORMAT 

HELP [command-name] 

command 

parameter 

command-name 

Specifies the name of a SYSGEN command or the keyword PARAMETERS. 
The command HELP PARAMETERS displays a list of all parameters and 
prompts for a parameter name. 

command 

qualifiers 

None. 

DESCRIPTION 

If you do not specify either a command name or the keyword PARAMETERS, 
HELP displays general information on the commands for which help is 
available. It then prompts with "Topic?" . You can supply a command name 
or the keyword PARAMETERS, or press RETURN. Specification of command 
names and qualifiers obtains more detailed information. If you respond with 
a RETURN, you exit from the HELP command. You can also exit from the 
HELP command by pressing CTRL/Z. Do not respond with CTRL/Y unless 
you want to exit from both HELP and SYSGEN. 


If the command you seek help on accepts qualifiers, the display of information 
for the command is followed by a prompt that includes the command name 
and "Subtopic?" . You can respond to this prompt with a qualifier name or 
by pressing RETURN. If you respond with a RETURN, you move to the first 
level of HELP and HELP prompts with "Topic?" . If you want to exit the 
HELP command directly from any level, press CTRL/Z. 


EXAMPLE 


SYSGEN> HELP AUTOCONFIGURE 
AUTOCONFIGURE 

Automatically configures the device driver database. It locates each 
device unit physically attached to the system, loads the appropriate 
driver, creates the appropriate data structures, and connects the driver 
to the device'8 interrupt. 

Format 

AUTOCONFIGURE ALL 
AUTOCONFIGURE adapter-spec 
CMKRNL privilege required 
Additional information available: 

adapter-spec ALL qualifiers 

/SELECT /EXCLUDE /LOG 

AUTOCONFIGURE Suptopic? 


The HELP command in this example displays information about the 
AUTOCONFIGURE command. 
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INSTALL 


INSTALL 

Activates a secondary paging or swapping file. The new paging or 
swapping file is effective until system shutdown. 

Use of the INSTALL command requires the CMKRNL privilege. 

FORMAT 

INSTALL file-spec 

command 

parameter 

file-spec 

Specifies the name of the secondary paging or swapping file created with the 
SYSGEN command CREATE. The default file type is SYS. 

command 

qualifiers 

/ll\IPUT=file-spec 

Specifies the input file. 

/OUTPUT=file-spec 

Specifies the output file. 

/PAGEFILE 

Specifies that the file is to be installed as an additional page file. All processes 
created after the page file is installed will use the page file with the most 
available free space; processes created before the additional page file is 
installed will continue to use the page file to which they are assigned. 

/SWAPFILE 

Specifies that the file is to be installed as an additional swap file. This swap 
file will augment the swap file installed during the bootstrap process. 


EXAMPLE 

SYSGEN> INSTALL SYS$SYSTEM:PAGEFILE.SYS /PAGEFILE 

The command in this example installs a secondary paging file. 
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LOAD 


LOAD 

Loads an I/O driver. DIGITAL supplies drivers for the standard 
devices. 

Use of the LOAD command requires the CMKRNL privilege. 

FORMAT 

LOAD file-spec 

command 

parameter 

file-spec 

Is the file specification of the driver image to be loaded. The default file type 
is EXE. 

If the entire file specification is the same as that of a driver already loaded, no 
load takes place. If only the file name is the same as that of a driver that is 
already loaded (but the file specification as a whole is different), the specified 
driver replaces the existing driver. 

command 

qualifiers 

None. 


EXAMPLE 

SYSGEN> LOAD SYS$SYSTEM:RTTDRIVER 

The command in this example loads the standard driver for a remote terminal. 
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MSCP 


MSCP 

Loads and starts the MSCP server. 

Use of the MSCP command requires the CMKRNL privilege. 

FORMAT 

MSCP 

command 

parameters 

None. 

command 

qualifiers 

/BUFFERvalue 

Specifies the amount of nonpaged pool preallocated to serve as buffers for 
disk I/O. The amount is indicated in bytes and rounded to the next higher 
page. Default is 32768. 

/HOST=value 

Specifies the maximum number of simultaneously connected hosts. Any 
attempt by another host to connect to the server beyond this number will fail. 
Default is 15. 

/MAXIMUM=value 

Specifies the amount of buffer space any single I/O request can consume. 

The amount is indicated in bytes and rounded to the next higher page. 
Default is one-half the amount indicated for the /BUFFER qualifier (16384). 

/MINIMUM=value 

Specifies the smallest amount of buffer space that will satisfy an I/O request 
without causing it to go into a buffer wait state. The amount is indicated in 
bytes and rounded to the next higher page. Default is 4096. 

/PACKETS=value 

Specifies the number of preallocated packets available for simultaneous 
outstanding I/O requests per host, and thus the receive credits extended to 
each host. Default is 4. 

/PRIORI TY=value 

Specifies the I/O priority (in the range of 0 to 31) for all disk requests from 
the server. Default is 4. 

/TIMEOUT=value 

Specifies, in seconds, the controller timeout period to the disk class driver. 
Default is 20. 


DESCRIPTION After issuing the MSCP command on a VAXcluster member node, you can 

serve disks to other VAXcluster members using the DCL command SET 
DEVICE/SERVED. (See the VAX/VMS DCL Dictionary.) 
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SYSGEN 

MSCP 


EXAMPLE 


SYSGEN> MSCP /MAXIMUM=32768 


This command loads and starts the MSCP server and limits to 32768 bytes 
the maximum amount of buffer space available for each I/O request. 
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RELOAD 


RELOAD 

Replaces a loaded device driver with a new version. 

Use of the RELOAD command requires the CMKRNL privilege. 

FORMAT 

R E LOA D file-spec 

command 

parameter 

file-spec 

Is the file specification of the new driver image. The default file type is EXE. 
The specified image is loaded and replaces any existing driver with the same 
file specification. 

command 

qualifiers 

None. 


EXAMPLE 

SYSGEN> RELOAD SYS$SYSTEM:RTTDRIVER 

The command in this example reloads the remote terminal driver. 
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SET/OUTPUT 


SET/OUTPUT 

Establishes a file to be used for output during the session. By 



default the output is written to SYS$OUTPUT, but you can use the 
SET/OUTPUT command to designate a disk file. 

At any time you can direct the output back to SYS$OUTPUT by 
using the SET/OUTPUT=SYS$OUTPUT command. 

FORMAT 

SET/OUTPUT[=] file-spec 

command 

parameter 

file-spec 

Is the name of the output file. The default file type is LIS. The equal sign ( = ) 
is optional. 


EXAMPLE 

SYSGEN> SET/OUTPUT=PARAMS.LIS 
SYSGEN> SHOW/ALL 
SYSGEN> SHOW/SPECIAL 


SYSGEN> EXIT 

In this example, output is directed to the file PAR AMS. LIS to capture a 
complete list of all the system parameters (including the SPECIAL parameters 
reserved for DIGITAL use) and their values. 
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SET parameter-name 


SET parameter-name 

Assigns a value to a system parameter in the SYSGEN work area 



This command does not modify parameter files, the current system 
parameter file on disk, or the active system; for information on 
performing these modifications, see the WRITE command. 

FORMAT 

SET parameter-name value 

command 

parameters 

parameter-name 

Specifies the name of a system parameter from Section A 2 or a period (.). 

A period is interpreted as a request for the system parameter specified in the 
last SET parameter or SHOW [parameter] command. See the description of 
the SHOW [parameter] command for an illustration of the use of the period 
in place of a parameter name. 

You can display the system parameters and request information on them with 
the SYSGEN command HELP PARAMETERS. 

value 

Is usually an integer or the keyword DEFAULT. Integer values must be 
within the defined minimum and maximum values for the parameter unless 
the SYSGEN command DISABLE CHECKS was specified. 

The keyword DEFAULT specifies the default value for the parameter. You 
can display the maximum, minimum, and default values for any parameter 
with the SYSGEN command SHOW [parameter]. 

You can specify values for certain SYSGEN parameters in hexadecimal or 
octal radixes, and for others as an ASCII string. To specify a value in octal 
or hexadecimal, prefix the value with %0 or %X, respectively. To specify a 
value in ASCII, enclose the value string in double quotes 

command 

qualifiers 

None. 


EXAMPLES 

Q SYSGEN> SET PFCDEFAULT 20 

The command in this example assigns a value of 20 to the PFCDEFAULT 
parameter. 

2 SYSGEN> SET GBLSECTIONS DEFAULT 

The command in this example assigns the default value (40) to the 
GBLSECTIONS parameter. 
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SET/STARTUP 


SET/STARTUP 

Names the site-independent startup command procedure to 



be associated with a parameter file for subsequent bootstrap 
operations. 

FORMAT 

SET/STARTUPH file-spec 

command 

parameter 

file-spec 

Is the file specification of a startup command procedure on the system 
disk (maximum of 31 characters). The equal sign is optional. The initial 
site-independent startup command procedure (as named in the software 
distribution kit) is SYS$SYSTEM:STARTUP.COM. 


DESCRIPTION The SET command does not modify either parameter files or the current 
system parameter file on disk; for information on performing these 
modifications, see the description of the WRITE command. 


EXAMPLE 

SYSGEN> SET/STARTUP SYS$SYSTEM:XSTARTUP.COM 

The command in this example assigns SYS$SYSTEM:XSTARTUP.COM as the 
current site-independent startup command procedure. 
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SHARE/CONNECT 


SHARE/CONNECT 

Connects a processor to a multiport memory unit already initialized 
by this or another processor. The number and name of the specified 
multiport memory unit must be those of an initialized unit, or an error 
condition results. 

Use of the SHARE/CONNECT command requires the CMKRNL 
privilege. 

FORMAT 

SHARE/CONNECT MPMn MPM-name 

command 

MPMn 

parameters 

Specifies the number on the front panel of the multiport memory unit being 
connected. 

MPM-name 

Is the name of the multiport memory unit as specified in a previous SHARE 
/INITIALIZE command. 

command 

/MAXCEFCLUSTERS=max-cef 

qualifiers 

Specifies the maximum number of common event flag clusters that the 
processor can create in the multiport memory unit. The default is no limit. 

/MAXGBLSECTIONS=max-gbl 

Specifies the maximum number of global sections that the processor can 
create in the multiport memory unit. The default is no limit. 

/MAXMA ILBOXES=max-mail 

Specifies the maximum number of mailboxes the processor can create in the 
multiport memory unit. The default is no limit. 


EXAMPLE 


SYSGEN> SHARE MPM1 SHR_MEM_1 

The command in this example connects a multiport memory unit. Since no 
qualifiers are specified, defaults apply to all the parameters. 

The unit with a 1 on the front panel must be initialized with the name 
SHF_MEM_1 for the command to work. 


SGIM-36 









SYSGEN 

SHARE/INITIALIZE 


SHARE/INITIALIZE 

Initializes a multiport memory unit and connects it to the processor 



on which SYSGEN is running. 

Use of the SHARE/INITIALIZE command requires the CMKRNL 
privilege. 

FORMAT 

SHARE/INITIALIZE MPMn MPM-name 

command 

parameters 

MPMn 

Specifies the number on the front panel of the multiport memory unit being 
connected. 

MPM-name 

Specifies the name by which the multiport memory unit is to be known to 
systems using it. The MPM-name is a 1 through 15 alphanumeric character 
string that may contain dollar signs ($) and underscores (_). 

command 

qualifiers 

/CEFCLUSTERS=cef 

Specifies the total number of common event flag clusters permitted in the 
multiport memory unit. The cef value is an integer with a default of 32. 

/GBLSECTIONS=gbl 

Specifies the total number of global sections permitted in the multiport 
memory unit. The gbl value is an integer with a default of 32. 

/MA ILBOXESmail 

Specifies the total number of mailboxes permitted in the multiport memory 
unit. The mail value is an integer with a default of 32. 

/MAXCEFCLUSTERS=max-cef 

Specifies the maximum number of common event flag clusters that the 
processor can create in the multiport memory unit. The default is no limit. 

/MAXGBLSECTIOI\IS=max-gbl 

Specifies the maximum number of global sections that the processor can 
create in the multiport memory unit. The default is no limit. 

/MAXMA ILBOXES=max-mail 

Specifies the maximum number of mailboxes the processor can create in the 
multiport memory unit. The default is no limit. 

/POOLBCOUNT=block-cnt 

Specifies the number of blocks allocated to the multiport memory unit's 
dynamic pool. The block-cnt value is an integer with a default of 128. 
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SHARE/INITIALIZE 


/POOLBSIZE=block-size 

Specifies the size of each block in the dynamic pool. The block-size value is 
an integer with a default of 128 bytes. 

/PRQCOUNT=prq-cnt 

Specifies the number of interprocessor request blocks (PRQs) allocated. The 
prq-cnt value is an integer with a default of 64. 


DESCRIPTION If the specified multiport memory unit is already initialized and connected to 

other active processors, the gbl, mail, cef, block-cnt, block-size, and 

prq-cnt parameter values are ignored, and the unit is simply connected to the 

processor. 


EXAMPLE 

SYSGEN> SHARE MPM1 SHR_MEM_1 /INITIALIZE - 

SYSGEN> /GBLSECTI0NS=128/MAILB0XES=64/CEFCLUSTERS=0 

The command in this example initializes a multiport memory unit with 
defaults on all but the gbl, mail, and cef parameters. In this example, assume 
that the number of the multiport memory unit as it appears on the front panel 
is 1 and the unit name is SHR__MEM_1. 
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SHOW/ADAPTER 

Lists all the nexus numbers and generic names on the adapter. 



Use of the SHOW/ADAPTER command requires the CMEXEC 
privilege. 

FORMAT 

SHOW/ADAPTER 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 

SYSGEN> SHOW/ADAPTER 

The following is a sample display produced by the SHOW/ADAPTER 
command: 

CPU Type: 11/780 



Nexus Generic Name or Description 
1 16K memory, non-interleaved 

3 UBO 

8 MBO 

9 MB1 
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SHOW/CONFIGURATION 

Displays information on the device configuration. 

Use of the SHOW/CONFIGURATION command requires the 
CMEXEC privilege. 


FORMAT SHOW/CONFIGURATION 


command 

parameters 

command 

qualifiers 


None. 


/ADAPTER=nexus 

Specifies the number of MASSBUS or UNIBUS adapters to be displayed. The 
nexus value can be expressed as an integer or with one of the generic names 
listed by the SYSGEN command SHOW/ADAPTER. 

/COMMAND-FILE 

Specifies that SYSGEN formats all the device data into 
CONNECT/ADAPTER=adapter-spec commands and writes the commands 
in an output file you specify. In this way, you can completely reconfigure a 
system without the use of the SYSGEN command AUTOCONFIGURE for 
UNIBUS devices. 

/OUTPUT=file-spec 

Specifies the file specification of an optional output file. If you specify the 
/OUTPUT qualifier, but omit the file type, the default is LIS. However, if you 
specify /COMMAND-FILE and /OUTPUT qualifiers together, the default file 
type for the output file is COM. 


DESCRIPTION SHOW/CONFIGURATION shows devices by name, number of units, nexus 

number, and adapter type, as well as by CSR and vector addresses. You can 
specify an output file with the /OUTPUT qualifier. 

Note that you can remove a device from the middle of the floating 
addresses without completely rejumpering the CSR and vector addresses 
of the remaining devices. For example, you would first modify your site- 
independent STARTUP.COM file to invoke the command file instead of 
issuing an AUTOCONFIGURE ALL command. Then you would issue the 
SHOW/CONFIGURATION/COMMAND-FILE/OUTPUT command to 
format and save the device data. Then, in the event you must bring the 
system down for service and remove a board, when the system reboots, 
SYS$SYSTEM:STARTUP.COM invokes your output file as a command 
procedure, and the system automatically configures the system's UNIBUS 
devices and MASSBUS devices for you. 

Remember that a new version of SYS$SYSTEM:STARTUP.COM is 
provided with each major release, so any modifications you have made to 
SYS$SYSTEM:STARTUP.COM you would need to repeat after you install the 
new version. 


SGN—40 


Caution: Although this technique can offer a convenient short-term solution, you 
should use AUTOCONFIGURE ALL whenever possible. 









SYSGEN 

SHOW/CONFIGURATION 


EXAMPLES 

Q SYSGEN> SHOW/CONFIGURATION 

The command in this example displays the current system I/O database. The 
following illustrates a typical display produced by this command: 




System CSR and Vectors on 15-APR-1984 

13:49:26 

.84 



Name: 

DRA 

Units: 

3 

Nexus:4 

(MBA) 






Name: 

DBA 

Units: 

1 

Nexus:4 

(MBA) 






Name: 

DBB 

Units: 

2 

Nexus:5 

(MBA) 






Name: 

DRB 

Units: 

1 

Nexus:5 

(MBA) 






Name: 

MTA 

Units: 

2 

Nexus:5 

(MBA) 






Name: 

DMA 

Units: 

2 

Nexus:8 

(UBA) 

CSR: 777440 

Vectorl: 

210 

Vector2: 

000 

Name: 

LPA 

Units: 

1 

Nexus:8 

(UBA) 

CSR: 777514 

Vectorl: 

200 

Vector2: 

000 

Name: 

DYA 

Units: 

2 

Nexus:8 

(UBA) 

CSR: 777170 

Vectorl: 

264 

Vector2: 

000 

Name: 

XMA 

Units: 

1 

Nexus:8 

(UBA) 

CSR: 760070 

Vectorl: 

300 

Vector2: 

304 

Name: 

XMB 

Units: 

1 

Nexus:8 

(UBA) 

CSR: 760100 

Vectorl: 

310 

Vector2: 

314 

Name: 

XMC 

Units: 

1 

Nexus:8 

(UBA) 

CSR: 760110 

Vectorl: 

320 

Vector2: 

324 

Name: 

TTA 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760130 

Vectorl: 

330 

Vector2: 

334 

Name: 

TTB 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760140 

Vectorl: 

340 

Vector2: 

344 

Name: 

TTC 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760150 

Vectorl: 

350 

Vector2: 

354 

Name: 

TTD 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760160 

Vectorl: 

360 

Vector2: 

364 

Name: 

TTE 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760170 

Vectorl: 

370 

Vector2: 

374 

Name: 

TTF 

Units: 

8 

Nexus:8 

(UBA) 

CSR: 760200 

Vectorl: 

400 

Vector2: 

404 


Q SYSGEN> SHOW/CONFIGURATION/COMMAND_FILE/OUTPUT=CONFIG.COM 


The command in this example formats all device data into CONNECT 
/ADAPTER=adapter-spec commands and writes the commands to the 
command file CONFIG.COM. The following is a typical command file 
produced by this command: 


$ RUN SYSSSYSTEM:SYSGEN 
AUTOCONFIGURE 4 
AUTOCONFIGURE 5 
CONNECT DMAO /ADAP=8 
CONNECT DMA1 
CONNECT LPAO 
CONNECT DYAO /ADAP=8 
CONNECT DYA1 /ADAP=8 
CONNECT XMAO 
CONNECT XMBO 
CONNECT XMCO 
CONNECT TTAO 
CONNECT TTA1 
CONNECT TTA2 


/ADAP=8 

/ADAP=8 


/ADAP=8 
/ADAP=8 
/ADAP=8 
/ADAP=8 
/ADAP=8 
/ADAP=8 


/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 

/CSR= 


7.0777440 

7.0777440 

7,0777514 

7,0777170 

7.0777170 

7.0760070 

7.0760100 

7.0760110 

7.0760130 

7.0760130 

7.0760130 


/VECT=7.0210 

/VECT=7.0210 

/VECT=7.0200 

/VECT=7.0264 

/VECT=7.0264 

/VECT=7.0300 

/VECT=7.0310 

/VECT=7.0320 

/VECT=7.0330 

/VECT=7.0330 

/VECT=7.0330 


/NUMV=01 

/NUMV=01 

/NUMV=01 

/NUMV=01 

/NUMV=01 

/NUMV=02 

/NUMV=02 

/NUMV=02 

/NUMV=02 

/NUMV=02 

/NUMV=02 


/DRIVER=DMDRIVER 

/DRIVER=DMDRIVER 

/DRIVER=LPDRIVER 

/DRIVER=DYDRIVER 

/DRIVER=DYDRIVER 

/DRIVER=XMDRIVER 

/DRIVER=XMDRIVER 

/DRIVER=XMDRIVER 

/DRIVER=DZDRIVER 

/DRIVER=DZDRIVER 

/DRIVER=DZDRIVER 


CONNECT TTF7 /ADAP=8 


/ CSR=7.0760200 


/VECT=7.0400 /NUMV=02 


/DRIVER=DZDRIVER 
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SHOW/DEVICE=device-driver 

Displays full information on device drivers loaded into the system, 
the devices connected to them, and their I/O databases. All 
addresses are in hexadecimal and are virtual. 

Use of the SHOW/DEVICE=device-driver command requires the 
CMEXEC privilege. 


FORMAT 

SHOW/DEVICE =device-driver 

command 

parameters 

None. 

command 

qualifiers 

None. 

DESCRIPTION 

The SHOW/DEVICE=device-driver command specifies that the following 
information be displayed about the specified device driver: 


Driver Name of the driver 

Start Starting address of the driver 

End Ending address of the driver 

Dev Name of each device connected to the driver 

DDB Address of the device's device data block 

CRB Address of the device's channel request block 

IDB Address of the device's interrupt dispatch block 

Unit Number of each unit on the device 

UCB Address of each unit's unit control block 

By default, if you omit the driver-name, information is displayed for all device 
drivers loaded into the system. 


EXAMPLE 

SYSGEN> SHOW/DEVICE=DBDRIVER 

The command in this example displays information about the DBDRIVER. 

_Driver_Start_End_Dev_DDB_CRB_IDB_Unit_UCB_ 

DBDRIVER 80082390 80082A7E 

DBA 80000848 800988C0 80098920 

0 8000087C 

1 8008A4F0 

2 8008A590 
5 8008A630 

7 8008A6D00) 
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SHOW/DRIVER=device-driver 

Displays brief information on device drivers loaded into the system, 
the devices connected to them, and their I/O databases. All 
addresses are in hexadecimal and are virtual. 

Use of the SHOW/DRIVER=device-driver command requires the 
CMEXEC privilege. 


FORMAT 

SHOW/DRIVER=dewce-dr/Ver 

command 

parameters 

None. 

command 

qualifiers 

None. 

DESCRIPTION 

The SHOW/DRIVER=device-driver command specifies that the following 
information be displayed about the specified device driver: 


• Driver—Name of the driver 

• Start—Starting address of the driver 

• End—Ending address of the driver 

By default, if you omit the driver-name, this information is displayed about 
all device drivers loaded into the system. 


EXAMPLE 

SYSGEN> SHOW/DRIVER 


The command in this example displays the starting and ending addresses of 
all drivers. 


Start_End_ 


_Driver.. 

RTTDRIVER 

NETDRIVER 

TMDRIVER 

DRDRIVER 

DDDRIVER 

DLDRIVER 

DMDRIVER 

LCDRIVER 

YCDRIVER 

XGDRIVER 

XDDRIVER 

DZDRIVER 

XMDRIVER 

DYDRIVER 

LPDRIVER 

DBDRIVER 

TTDRIVER 

OPERATOR 

NLDRIVER 

MBDRIVER 


800C1060 
800BAFD0 
800B3950 
800B2950 
800B1740 
800B0D10 
800B0070 
800AFC50 
800AED20 
800AC3F0 
800AA5A0 
800A4F30 
800A3E10 
800A3300 
800A2E90 
800DE7A0 
800DC770 
80001650 
80001626 
800015FC 


800C1960 

800BD4B0 

800B4BF0 

800B3290 

800B2060 

800B15A0 

800B0990 

800AFFB0 

800AF3E0 

800AE9E0 

800AC380 

800A59B0 

800A4A50 

800A3C30 

800A3300 

800DEFB7 

800DE79B 

80001F8B 

80001D20 

80001CBE 
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SHOW [parameter] 

Displays the values of system parameters in the SYSGEN work area, 



plus the default, minimum, and maximum values of the parameters 
and their units of measure. 

FORMAT 

SHOW [parameter-name] 

command 

parameter 

parameter-name 

Specifies the name of a system parameter from Section A.2 or a period (.). 

A period is interpreted as a request for the system parameter specified in the 
last SET parameter-name or SHOW [parameter] command. 

command 

qualifiers 

/ACP 

Specifies that all ACP parameter values are displayed. 

/ALL 

Specifies that all parameter values except SPECIAL parameter values are 
displayed. 

/CLUSTER 

Specifies that all CLUSTER parameter values are displayed. 

/DYNAMIC 

Specifies that all DYNAMIC parameter values are displayed. 

/GEN 

Specifies that all GEN parameter values are displayed. 

/HEX 

Specifies that the values of parameters be displayed in hexadecimal 
representation. Specify the /HEX system parameter name or the parameter 
type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX is 
ignored. 

/JOB 

Specifies that all JOB parameter values are displayed. 

/LGI 

Specifies that all LGI parameter values are displayed. 

/MAJOR 

Specifies that all MAJOR parameter values are displayed. 

/NAMES 

Specifies that the names of all parameters are displayed. 
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/PQL 

Specifies that all PQL parameter values are displayed. 

/RMS 

Specifies that all VAX RMS parameter values are displayed. 

/scs 

Specifies that all SCS parameter values are displayed. 

/SPECIAL 

Specifies that all parameter values reserved for DIGITAL use are displayed. 

/SYS 

Specifies that all SYS parameter values are displayed. 

/TTY 

Specifies that all terminal parameter values are displayed. 


DESCRIPTION Parameter values are displayed in decimal unless the /HEX qualifier is 

specified. Note that ASCII values are displayed in ASCII by default. 

When parameter names are abbreviated, the first parameter matching 
the abbreviation is selected for display. No ambiguity checks are made. 

For example, a specification of SHOW GBL displays the GBLSECTIONS 
parameter. To display the GBLPAGFIL parameter, you must specify SHOW 
GBLPAGF (to avoid further ambiguity with the GBLPAGES parameter). 

You can use a period (.) to indicate that you want to work with the system 
parameter that was specified in the last SET parameter-name or SHOW 
[parameter] command. 


EXAMPLES 

Q SYSGEN> SHOW GBLSECTIONS 


GBLSECTIONS 

100 

40 

20 

-1 

Sections 

SYSGEN> SET . 110 
SYSGEN> SHOW 
GBLSECTIONS 

110 

40 

20 

-1 

Sections 


In this example, the user first displays the values of the GBLSECTIONS 
parameter, and then refers to the parameter with a period to set its current 
value to 110. The next SHOW command also uses the period notation to 
obtain confirmation that the change occurred. 
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0 SYSGEN> SHOW/ACP 


The command in this example produces the following output: 


Parameters in use: Active 

Parameter Name 

ACP_MULTIPLE 

ACP.SHARE 

ACP.MAPCACHE 

ACP.HDRCACHE 

ACP.DIRCACHE 

ACP_DINDXCACHE 

ACP.WORKSET 

ACP.FIDCACHE 

ACP_EXTCACHE 

ACP.EXTLIMIT 

ACP_QUOCACHE 

ACP_SYSACC 

ACP_MAXREAD 

ACP.WINDOW 

ACP.WRITEBACK 

ACP_DATACHECK 

ACP.BASEPRIO 

ACP.SWAPFLGS 

ACP_XQP_RES 

ACP.REBLDSYS 


Current 

Default 

Minimum 

0 

1 

0 

1 

1 

0 

52 

8 

1 

138 

128 

2 

138 

80 

2 

37 

25 

2 

0 

0 

0 

64 

64 

0 

64 

64 

0 

300 

300 

0 

130 

64 

0 

4 

8 

0 

32 

32 

1 

7 

7 

1 

1 

1 

0 

2 

2 

0 

8 

8 

4 

14 

15 

0 

1 

1 

0 

0 

1 

0 


Maximum Unit Dynamic 


1 Boolean D 

1 Boolean 
-1 Pages D 

-1 Pages D 

-1 Pages D 

-1 Pages D 

-1 Pages D 

-1 File-Ids D 

-1 Extents D 

1000 Percent/10 D 

-1 Users D 

-1 Directories D 

64 Blocks D 

-1 Pointers D 

1 Boolean D 

3 Bit-mask D 

31 Priority D 

15 Bit-mask D 

1 Boolean 
1 Boolean 


0 SYSGEN> SHOW/ACP/HEX 


The command in this example produces a hexadecimal display of the values 
of the ACP system parameters. 


Parameters in use: 
Parameter Name 

Active 

Current 

Default 

Minimum 

Maximum 

Unit Dynamic 

ACP.MULTIPLE 

00000000 

00000001 

00000000 

00000001 

Boolean 

D 

ACP_SHARE 

00000001 

00000001 

00000000 

00000001 

Boolean 


ACP.MAPCACHE 

00000034 

00000008 

00000001 

FFFFFFFF 

Pages 

D 

ACP.HDRCACHE 

0000008A 

00000080 

00000002 

FFFFFFFF 

Pages 

D 

ACP.DIRCACHE 

0000008A 

00000050 

00000002 

FFFFFFFF 

Pages 

D 

ACP.DNDXCACHE 

00000025 

00000019 

00000002 

FFFFFFFF 

Pages 

D 

ACP.WORKSET 

00000000 

00000000 

00000000 

FFFFFFFF 

Pages 

D 

ACP.FIDCACHE 

00000040 

00000040 

00000000 

FFFFFFFF 

File-Ids 

D 

ACP _ EXT CACHE 

00000040 

00000040 

00000000 

FFFFFFFF 

Extents 

D 

ACP.EXTLIMIT 

0000012C 

0000012C 

00000000 

000003E8 

Percent/10 

D 

ACP_QUOCACHE 

00000082 

00000040 

00000000 

FFFFFFFF 

Users 

D 

ACP.SYSACC 

00000004 

00000008 

00000000 

FFFFFFFF 

Directories 

D 

ACP.MAXREAD 

00000020 

00000020 

00000001 

00000040 

Blocks 

D 

ACP.WINDOW 

00000007 

00000007 

00000001 

FFFFFFFF 

Pointers 

D 

ACP.WRITEBACK 

00000001 

00000001 

00000000 

00000001 

Boolean 

D 

ACP.DATACHECK 

00000002 

00000002 

00000000 

00000003 

Bit-mask 

D 

ACP.BASEPRIO 

00000008 

00000008 

00000004 

000000IF 

Priority 

D 

ACP.SWAPFLGS 

0000000E 

0000000F 

00000000 

0000000F 

Bit-mask 

D 

ACP.XQP.RES 

00000001 

00000001 

00000000 

00000001 

Boolean 


ACP.REBLDSYS 

00000000 

00000001 

00000000 

00000001 

Boolean 
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SHOW/STARTUP 

Displays the name of the current site-independent startup command 



procedure. 

FORMAT 

SHOW/STARTUP 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 

SYSGEN> SHOW/STARTUP 
Startup command file = 

■- SYSSSYSTEM:STARTUP.COM 

The command in this example displays the name of the site-independent 
startup command procedure. 
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SHOW/UNIBUS 


Displays the addresses in UNIBUS I/O space that can be addressed. 

Use of the SHOW/UNIBUS command requires the CMKRNL 
privilege. 

FORMAT 

SHOW/UNIBUS 

command 

parameters 

None. 

command 

qualifier 

/A DAPTER[=nexus] 

Specifies that the address of the specified UNIBUS adapter is to be displayed. 
The nexus value specifies the number of the UNIBUS. It can be expressed as 
an integer or as one of the names listed by the SYSGEN command 

SHOW/ADAPTER. If you do not specify a particular adapter, every UNIBUS 
is displayed. 

DESCRIPTION 

The SHOW/UNIBUS command reads all device registers. For some 
controllers the result may be reading a character out of a buffer or some 
other undesired action. Thus, you should use the SHOW/UNIBUS command 
with caution, only when it is necessary to debug a UNIBUS configuration. 


EXAMPLE 


SYSGEN> SHOW/UNIBUS/ADAPTER=4 


**UNIBUS map for nexus #4 


Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 

Address 


760070 (8001F838) 
760072 (8001F83A) 
760074 (8001F83C) 
760076 (8001F83E) 
760100 (8001F840) 
760102 (8001F842) 
760104 (8001F844) 
760106 (8001F846) 
760110 (8001F848) 
760112 (8001F84A) 
760114 (8001F84C) 
760116 (8001F84E) 


Address 760130 
Address 760132 
Address 760134 
Address 760136 
Address 760140 
Address 760142 
Address 760144 


(8001F858) 

(8001F85A) 

(8001F85C) 

(8001F85E) 

(8001F860) 

(8001F862) 

(8001F864) 


The command in this example displays the available addresses for nexus 4. 

on 15-APR-1984 14:19:38.00 ** 
responds with value 9B6E (hex) 
responds with value 0340 (hex) 
responds with value 403C (hex) 
responds with value 0240 (hex) 
responds with value 8000 (hex) 
responds with value 0340 (hex) 
responds with value 7DAC (hex) 
responds with value 000A (hex) 
responds with value 8000 (hex) 
responds with value 0340 (hex) 
responds with value AD5C (hex) 
responds with value 000A (hex) 
responds with value 9B6E (hex) 
responds with value 030D (hex) 
responds with value FFOO (hex) 
responds with value CECE (hex) 
responds with value 4060 (hex) 
responds with value 0761 (hex) 
responds with value FFOO (hex) 
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TERMINAL/ECHO 

Modifies the CTRL/C, CTRL/O, CTRL/Y, and CTRL/Z echo strings 



on a system-wide basis. 

FORMAT 

TERMINAL/ECHO 

command 

parameters 

command 

qualifiers 

None. 

None. 


DESCRIPTION Before issuing the TERMINAL/ECHO command, you must edit the file 

SYSGTTSTR.MSG in SYS$EXAMPLES. The file contains detailed instructions 
for the editing procedure. 

When you issue the TERMINAL/ECHO command after editing the file, the 
modifications you have specified are carried out. 
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USE 

Initializes the SYSGEN work area with system parameter values and 
the name of the site-independent startup command procedure. You 
specify the source for both the parameter values and the procedure 
name. They can be retrieved from a parameter file, the current 
system parameter file on disk, the active system in memory, or the 
default list. 

Existing values in the SYSGEN work area are overwritten. 

FORMAT 

USE file-spec 

command 

parameter 

file-spec 

Is the file specification of a system parameter file from which data is to be 
retrieved. The parameter file is either SYS$SYSTEM:AUTOGEN.PAR or the 
name of a parameter file you created with the SYSGEN command WRITE. 
The default file type is PAR. 

In place of a file-spec, you may specify one of the following keywords: 

CURRENT 

Specifies that source information is to be retrieved from the current system 
parameter file on disk. 

ACTIVE 

Specifies that source information is to be retrieved from the active system in 
memory. 

DEFAULT 

Specifies that source information is to be retrieved from the default list. 

command 

qualifiers 

None. 

EXAMPLE 

SYSGEN > USE DEFAULT 

The command in this example initializes the SYSGEN work area with 
parameter values that should allow VAX/VMS to boot on any standard 
configuration. The initial values of the SYSGEN work area when the utility is 
invoked are the active values. 
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WRITE 

Writes the system parameter values and the name of the site- 
independent startup command procedure from the SYSGEN work 
area to your choice of a parameter file, the current system parameter 
file on disk, or the active system in memory. (However, only the 
dynamic parameter values are written to the active system.) 

Use of the WRITE ACTIVE command requires the CMKRNL privilege. 
Use of the WRITE CURRENT command requires the SYSPRV 
privilege. 

FORMAT 

WRITE file-spec 

command 

parameter 

file-spec 

Is the file specification of a new parameter file to be created. The default 
file-type is PAR. 

In place of a file-spec, you may specify one of the following keywords: 

CURRENT 

Specifies that source information is to be written to the current system 
parameter file on disk. 

ACTIVE 

Specifies that source information is to be written to the active system in 
memory. 

DEFAULT 

Specifies that source information is to be written to the default list. 

command 

qualifiers 

None. 

DESCRIPTION 

Both the WRITE ACTIVE and WRITE CURRENT commands send a message 
to OPCOM and log the event. 


EXAMPLES 

Q SYSGEN> WRITE SYS$SYSTEM:SPECIAL 

The command in this example creates a new parameter specification file. 

Q SYSGEN> WRITE CURRENT 

The command in this example modifies the current system parameter file on 
disk (SYS$SYSTEM:VAXVMSSYS.PAR). 
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A Supplemental SYSGEN Information 


This section describes the functions of the VAX/VMS system parameters. 


A.1 



Parameter Categories 

The system parameters fall into ten general categories: 

• ACP—Parameters associated with file system caches and Files-11 ancillary 
control processes (ACPs). 

• CLUSTER—Parameters that affect VAXcluster operation. 

• JOB—Job control parameters. 

• LGI—Login security parameters. 

• PQL—Parameters associated with process creation limits and quotas. 

• RMS—Parameters associated with VAX RMS. 

• SCS—Parameters that control System Communication Services (SCS) and 
port driver operation. The parameters that affect SCS operation have the 
prefix SCS. The parameters that affect the CI780/CI750 port driver have 
the prefix PA. 

• SPECIAL—Special parameters used by DIGITAL. These parameters are 
not documented; they should be used only by DIGITAL personnel. 

• SYS—Parameters that affect overall system operation. 

• TTY—Parameters associated with terminal behavior. 

There are also four parameters that can be user-defined: USERD1, USERD2, 
USER3, and USER4. USERD1 and USERD2 are dynamic. 

Parameters may have one or more of the following attributes: 

• DYNAMIC—Active values can be modified 

• GEN—Affect the creation and initialization of data structures at bootstrap 
time 

• MAJOR—Most likely to require modification 

These attributes are noted in the detailed parameter descriptions in 
Section A.2. 

Note: Each parameter has associated with it default, minimum, and maximum 
values that define the scope of allowable values. To determine these 
values, you can invoke SYSGEN and issue a SHOW [parameter-name] 
command (with appropriate qualifiers). For example, to display the values 
for WSMAX, you can specify SHOW WSMAX; to display the values for 
the TTY parameters, you can specify SHOW/TTY. You can also display 
parameters grouped by attributes. To display DYNAMIC parameters, for 
instance, you can specify SHOW/DYNAMIC. 
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Following is a list of system parameters grouped according to category. An 
asterisk indicates that a parameter is dynamic. 


ACP Parameters 
ACP_MULTIPLE* 
ACP_HDRCACHE* 
ACP—FIDCACHE* 
ACP-QUOCACHE 
ACP—WINDOW* 
ACP—BASEPRIO* 
ACP_REBLDSYS 


ACP_SHARE* 

ACP_DIRCACHE* 

ACP_EXTCACHE* 

ACP_SYSACC* 

ACP_WRITEBACK* 

ACP—SWAPFLGS* 

ACP-DINDXCACHE 


ACP-MAPCACHE* 
ACP—WORKSET * 
ACP—EXTLIMIT* 
ACP_MAXREAD* 
ACP_DAT ACHECK< 
ACP_XQP_RES* 


CLUSTER Parameters 

QUORUM 

VOTES 

QDSKINTERVAL 

RECNXINTERVAL* 

DISK-QUORUM* 

ALLOCLASS* 

VAXCLUSTER 

QDKSVOTES 

LOCKDIRWT 


JOB Parameters 

DEFPRI* 

IJOBLIM* 

BJOBLIM* 

NJOBLIM* 

RJOBLIM* 

DEFQUEPRI* 

MAXQUEPRI* 




LGI Parameters 

LGI—BRK—LIM* 

LGI-BRK—TMO* 

LGI—HID—TIM* 

LGI—RETRY—LIM* 

LGI—RETRY—TMO* 

LGI—BRK—TERM* 

LGI-BRK—DISUSER* 




PQL Parameters 


PQI_DASTLM* 

PQI_MBIOLM* 

PQI_DCPULM* 

PQI_MDIOLM* 

PQI_DPGFLQUOT A* 

PQI_MPRCLM* 

PQI_DWSDEFAULT 

PQI_MWSQUOT A* 

PQI DENQLM* 


PQI_MASTLM* 

PQI_DBYTLM* 

PQI_MCPULM* 

PQI_DFILLM* 

PQI_MPGFLQUOT A* 

PQI _ DT QELM* 

PQI_MWSDEFAULT 

PQI_DWSEXTENT * 

PQI_MENQLM* 


PQI_DBIOLM* 

PQI_MBYTLM* 

PQI_DDIOLM* 

PQI_MFILLM* 

PQI_DPRCLM* 

PQI _ MTQELM* 

PQI_DWSQUOT A* 

PQI_M WSEXTENT 4 
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RMS Parameters 


RMS_DFNBC* 

RMS_DFMBFSDK* 

RMS—DFMBFSMT * 

RMS_DFMBFSUR* 

RMS_DFMBFREL* 

RMS—DFMBFIDX* 

RMS_DFMBFHSH* 

RMS—PROLOGUE* 

RMS—EXTEND—SIZE* 

RMS_FILEPROT 

RMS_GBLBUFQUO* 



SCS Parameters 

SCSBUFFCNT 

SCSCONNCNT 

SCSRESPCNT 

SCSMAXDG 

SCSMAXMSG 

SCSFLOWCUSH* 

SCSSYSTEMID 

SCSSYSTEMIDH 

SCSNODE 

PRCPOLINTERVAL* 

PASTIMOUT* 

PASTDGBUF 

PANUMPOLL* 

PAMAXPORT* 

PAPOLLINTERVAL* 

PAPOOLINTERVAL* 

PASANITY* 

PANOPOLL* 

UDABURSTRATE 




SYS Parameters 

PFCDEFAULT* 

KFILSTCNT 

GBLSECTIONS 

GBLPAGES 

GBLPAGFIL 

MAXPROCESSCNT 

PROCSECTCNT 

MINWSCNT 

PAGFILCNT 

SWPFILCNT 

SYSMWCNT 

INTSTKPAGES 

BALSETCNT 

IRPCOUNT 

IRPCOUNTV 

WSMAX 

NPAGEDYN 

NPAGEVIR 

PAGEDYN 

VIRTU ALPAGECNT 

SPTREQ 

LRPCOUNT 

LRPCOUNTV 

LRPSIZE 

SRPCOUNT 

SRPCOUNTV 

QUANTUM* 

MPW_WRTCLUSTER 

MPW_HILIMIT 

MPW—LOLIMIT 

MPW_THRESH* 

MPW_WAITLIMIT* 

PFRATL* 

PFRATH* 

WSINC* 

WSDEC* 

AWSMIN* 

AWSTIME* 

SWPOUTPGCNT* 

LONGWAIT* 

EXTRACPU* 

MAXSYSGROUP* 

MVTIMEOUT* 

MAXBUF* 

DEFMBXBUFQUO* 

DEFMBXMXMSG* 

DEFMBXNUMMSG* 

FREELIM 

FREEGOAL 

GROWLIM* 

BORROWLIM* 

XFMAXRATE* 

LAMAPREGS 

REALTIME—SPTS 

CLISYMTBL* 

LOCKIDTBL 

LOCKIDTBI_MAX* 

RESHASHTBL 

DEADLOCK_WAIT* 

TIMEPROMPTWAIT 

BUGREBOOT* 

CRDENABLE 

DUMPBUG 

BUGCHECKFATAL* 

SETTIME 

UAF ALTERNATE 

MOUNTMSG* 

DISMOUMSG* 

DEFPRI* 

DORM ANTW AIT* 

SAVEDUMP 

STARTUP-PI-8 

LNMPHASHTBL 

LNMSHASHTBL 

TAILORED 
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TTY Parameters 

TTY_SCANDELT A 

TTY_DIALTYPE 

TTY_SPEED 

TTY_RSPEED 

TTY_PARITY 

TTY_BUF 

TTY_DEFCHAR 

TTY_DEFCHAR2 

TTY_TYPAHDSZ 

TTY_ALTYPAHD 

TTY_ALT ALARM 

TTY_DMASIZE* 

TTY_PROT 

TTY_OWNER 

TTY—CLASSNAME 

TTY_SILOTIME 

TTY_AUTOCHAR 

TTY_TIMEOUT 


A.2 Parameter Descriptions 

This section describes system parameters in more detail and provides 
guidelines to help you decide whether you should consider modifying 
them. The parameters are presented in alphabetical order, and the attributes 
DYNAMIC, GEN, and MAJOR are indicated as follows: 

DYNAMIC—D 
GEN—G 
MAJOR—M 

Where the descriptions refer to the default value, they mean the value of 
the parameter that is contained internally in SYSGEN as the default value. 
The default values allow booting on any supported VAX/VMS configuration. 
(SYSGEN displays these default values under the heading "default" when 
you issue the SYSGEN command SHOW [parameter] for one of the parameter 
categories or attributes. Also, these are the parameter values you can establish 
with the SYSGEN command USE DEFAULT.) 

Where the descriptions refer to the computed, installed value, they mean 
the value derived by the AUTOGEN commmand procedure (see the Guide 
to VAX/VMS System Management and Daily Operations. These values are 
appropriate for booting on the specific configuration that initiated the 
AUTOGEN procedure. 

Note: In Versions of VAX/VMS previous to Version 4.0, a separate process 
called the Ancillary Control Process (ACP) performed such operations 
as file opens, closes, window turns, and so forth. Version 4.0 introduces 
the XQP (extended QIO) procedure, which allows each process on the 
system to perform these operations. Consequently, many ACP parameters 
are applicable only when Files-11 structure level 1 disks are mounted 
or when an ACP is specifically requested during a mount command. For 
compatibility reasons, the names of the parameters have not changed. 

Command Parameters 
ACP—BASEPRIO (D) 

ACP—BASEPRIO sets the base priority for all ACPs. The DCL command SET 
PROCESS/PRIORITY can be used to reset the base priorities of individual 
ACPs. 

Normally the computed, installed value is adequate. Not applicable for 
XQPs. 

ACP—DATACHECK (D) 

ACP—DATACHECK enables verification of reading and/or writing of file 
structure data (for example, directories and file headers): a specification of 3 
means read and write checks; 2 means write check only; 1 means read check 
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only; 0 means no checks. On a read check, the XQP information is read twice 
and compared. On a write check, the XQP information is written, and then 
read and compared. 

ACP—DIRCACHE (D) 

ACP—DIRCACHE sets the number of pages for caching directory blocks. Too 
small a value causes excessive XQP I/O operations, while too large a value 
causes excessive physical memory to be consumed by the directory data block 
cache. 

Normally the computed, installed value is adequate. 

ACP—DINDXCACHE (D) 

ACP—DINDXCACHE controls the size of the directory index cache and the 
number of buffers used on a cache-wide basis. In addition, 
ACP—DINDXCACHE builds a temporary index into the directory file, thereby 
reducing search time and directory header lookup operations. This parameter 
replaces the ACP—SYSACC parameter for Files-11 ODS-2 disks. 

Normally the computed, installed value is adequate. 

ACP—EXTCACHE (D) 

ACP—EXTCACHE sets the number of entries in the extent cache. Each entry 
points to one contiguous area of free space on disk. A specification of 0 
means no cache. Too small a value causes excessive XQP I/O operations, 
while too large a value causes excessive physical memory to be consumed by 
the extent cache. 

Normally the computed, installed value is adequate. 

ACP—EXTLIMIT (D) 

ACP—EXTLIMIT specifies the maximum amount of free space to which the 
extent cache can point, expressed in thousandths of the currently available 
free blocks on the disk. For example, if available free space on the disk is 
20,000 blocks, a specification of 10 limits the extent cache to 200 blocks. 

Normally the computed, installed value is adequate. Users with 4 or more 
VAXcluster node systems may want to adjust this parameter. 

ACP—FIDCACHE (D) 

ACP—FIDCACHE sets the number of file identification slots cached. A 
specification of 1 means no cache. Too small a value causes excessive XQP 
I/O operations, while too large a value causes excessive physical memory to 
be consumed by the FID caches. 

Normally the computed, installed value is adequate. 

ACP—HDRCACHE (D) 

ACP—HDRCACHE sets the number of pages for caching file header blocks. 
Too small a value causes excessive XQP I/O operations, while too large a 
value causes excessive physical memory to be consumed by the file header 
caches. 

Normally the computed, installed value is adequate. 

ACP—MAPCACHE (D) 

ACP—MAPCACHE sets the number of pages for caching index file bit map 
blocks. Too small a value causes excessive XQP I/O operations, while too 
large a value causes excessive physical memory to be consumed by the bit 
map cache. 
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Normally the computed, installed value is adequate. 

ACP—MAXREAD (D) 

ACP—MAXREAD sets the maximum number of directory blocks read in one 
I/O operation. 

Normally the computed, installed value is adequate. 

ACP_MULTIPLE (D) 

ACP—MULTIPLE enables or disables the default creation of a separate disk 
XQP cache for each volume mounted on a different device type. Prior to 
Version 4.0, a separate ACP process was created for each device type if 
this parameter was enabled. Since ACP operations are now handled by 
the per process XQP, such separate processes are no longer created. In 
general, there is no reason to have multiple caches. One large cache is more 
efficient than several small ones. ACP_MULTIPLE can be overridden on an 
individual-volume basis with the DCL command MOUNT. 

ACP_QUOCACHE (D) 

ACP_QUOCACHE sets the number of quota file entries cached. A 
specification of 0 means no cache. Too small a value causes excessive XQP 
I/O operations, while too large a value causes excessive physical memory to 
be consumed by the quota caches. Normally the computed, installed value is 
adequate. 

ACP—REBLDSYS 

ACP—REBLDSYS specifies whether the system disk should be rebuilt if it was 
improperly dismounted with extent caching, file number caching, or diskquota 
caching enabled. The ACP—REBLDSYS default value (1) ensures that the 
system disk is rebuilt. 

Depending on the amount of caching enabled on the volume before it was 
dismounted, the rebuild operation may consume a considerable amount of 
time. Setting the value of ACP—REBLDSYS to 0 specifies that the disk should 
be returned to active service immediately. In that case, you should issue the 
DCL command SET VOLUME /REBUILD at a later time to rebuild the disk. 

ACP—SHARE (D) 

ACP—SHARE enables or disables the creation of a global section for the first 
ACP used, so that succeeding ACPs may share its code. This parameter 
should be set off (0) when ACP-MULTIPLE is off. 

ACP—SWAPFLGS (D) 

ACP—SWAPFLGS enables or disables swapping for four classes of ACPs 
through the value of a 4-bit number: 


Bit Class of ACP 

O Disks mounted by MOUNT/SYSTEM 

1 Disks mounted by MOUNT/GROUP 

2 Private disks 

3 Magnetic tape ACP 


If the value of the bit is 1, the corresponding class of ACPs can be swapped. 
The value of decimal 15 (hexadecimal F—all bits on) enables swapping for 
all classes of ACP. A value of decimal 14 disables swapping for ACPs for 
volumes mounted with the /SYSTEM qualifier, but leaves swapping enabled 
for all other ACPs. Note that one will only have disk ACPs present if they 
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are specifically requested at mount time or if a Files-11 structure level 1 disk 
is mounted. In general, only bit 3 is significant since there will usually be no 
file ACPs. 

ACP-SYSACC (D) 

ACP—SYSACC sets the number of directory file control blocks (FCBs) that 
will be cached for disks mounted with the /SYSTEM qualifier. Each directory 
FCB contains a 16-byte array containing the first letter of the last entry in each 
block of the directory (or group of blocks if the directory exceeds 16 blocks). 
Since entries in a directory are alphabetical, the cached FCB provides quick 
access to a required directory block. This parameter value should be roughly 
equivalent to the number of directories that will be in use concurrently on 
each system volume. It may be overridden on a per-volume basis with the 
/ACCESSED qualifier to the DCL command MOUNT. The value should be 
kept low in systems with small physical memory and little file activity as the 
FCBs require a significant amount of space in the nonpaged dynamic pool. 

Too small a value causes excessive XQP I/O operations, while too large a 
value causes excessive physical memory to be consumed by the FCB caches. 

Normally the computed, installed value is adequate. 

ACP—WINDOW (D) 

ACP—WINDOW sets the default number of window pointers to be allocated 
in a window for a default file access, for disks mounted with the /SYSTEM 
qualifier. 

Normally the computed, installed value is adequate. 

ACP—WORKSET (D) 

ACP—WORKSET sets the default size of a working set for an ACP. A value 
of 0 permits the ACP to calculate the size. This value should be nonzero only 
on small systems where memory is tight. Too small a value causes excessive 
ACP paging, while too large a value causes excessive physical memory to 
be consumed by the ACP. Note that this parameter has no effect on the per 
process XQP. 

Normally the computed, installed value is adequate. 

ACP—WRITEBACK (D) 

ACP—WRITEBACK enables by default the deferred writing of file headers. A 
specification of 0 causes all modifications of file headers to be written to disk 
immediately. 

AC P_XQP_R ES (D) 

ACP—XQP—RES controls whether the XQP is currently in memory. The 
default value (1), specifies that the XQP is permanently in memory. You 
should change the default only on restricted memory systems with a 
small number of users and little or no file activity that would require XQP 
intervention. Such activity includes file opens, closes, directory lookups, 
window turns, and so forth. 

ALLOCLASS (D) 

ALLOCLASS determines the device allocation class for the system. The 
device allocation class is used to derive a common lock resource name for 
multiple access paths to the same device. 
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AWSMIN (D) 

AWSMIN establishes the lowest number of pages to which a working set 
limit can be decreased by automatic working set adjustment. 

Normally the default value is adequate. 

AWSTIME (D) 

AWSTIME specifies the minimum amount of processor time that must elapse 
for the system to collect a significant sample of a working set's page fault rate. 
The time is expressed in units of 10 milliseconds. The default value of 20, for 
example, is 200 milliseconds. 

BALSETCNT (G,M) 

BALSETCNT sets the number of balance set slots in the system page table. 
Each memory-resident working set requires 1 balance set slot. Each balance 
set slot requires 4 bytes of permanently resident memory per 128 virtual 
pages (as specified in the VIRTUALPAGECNT parameter). 

You can monitor the active system with the DCL command SHOW MEMORY 
or the MONITOR PROCESSES command of the Monitor Utility to determine 
the actual maximum number of working sets in memory. If this number is 
significantly lower than the value of BALSETCNT, this parameter value may 
be lowered. If all balance set slots are being used, the value of BALSETCNT 
should be raised. 

BALSETCNT should never be set to a value higher than 2 less than 
MAXPROCESSCNT. If physical memory is a significant system constraint, 
you should consider lowering this value even further. However, if your 
system runs with a number of processes nearly equal to MAXPROCESSCNT, 
lowering BALSETCNT will force swapping to occur, which can affect system 
performance. 

BJOBLIM (D) 

BJOBLIM enables the limit for batch jobs. 

BORROWLIM (D,M) 

BORROWLIM defines the minimum number of pages required on the free 
page list before the system will permit process growth beyond the working 
set quota (WSQUOTA) for the process. This parameter should always be 
greater than FREELIM. 

With the system's use of automatic working set adjustment, via the 
parameters WSINC, PFRATH, and AWSTIME, this parameter allows a process 
to grow beyond the value set by the working set quota (WSQUOTA) to the 
working set quota extent (WSEXTENT) on a system that has a substantial 
memory on the free page list. Such growth attempts to alleviate heavy 
page faulting. To make use of this growth, you must also set the user's 
WSEXTENT authorization quota to a larger number than the WSQUOTA 
value. 

BUGCHECKFATAL (D) 

BUGCHECKFATAL enables or disables the conversion of nonfatal bugchecks 
into fatal bugchecks. The system must be rebooted on a fatal bugcheck. 

A nonfatal bugcheck only places an entry in the error log and deletes the 
corresponding process. 

This parameter should normally be off (0); you should set it on (1) only 
when the executive is being debugged. 

Normally the default value is adequate. 
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# 



BUGREBOOT (D) 

BUGREBOOT enables or disables automatic rebooting of the system if a fatal 
bugcheck occurs. This parameter should normally be on, (1) and off (0) only 
when the executive is being debugged. 

CLISYMTBL (D) 

CLISYMTBL sets the size of the command interpreter symbol table, which 
controls the number of DCL or MCR symbols that can be created. 

Normally the default value is adequate. 

CRDENABLE 

CRDENABLE enables or disables detection and logging of memory-corrected 
read data (ECC) errors. This parameter should normally be on (1). 

DEADLOCK_WAIT (D) 

DEADLOCK—WAIT defines the number of seconds that a lock request 
must wait before the system initiates a deadlock search on behalf of that 
lock. Setting DEADLOCK—WAIT to 0 disables deadlock checking. Setting 
DEADLOCK—WAIT to a value greater than 0 but still less than the default 
setting provides faster detection of deadlocks, but requires more CPU usage. 

Normally the default value is adequate. 

DEFMBXBUFQUO (D) 

DEFMBXBUFQUO sets the default for the mailbox buffer quota size in bytes 
when this value is not specified in a Create Mailbox ($CREMBX) system 
service call. 

Normally the default value is adequate. 

DEFMBXMXMSG (D) 

DEFMBXMXMSG sets the default for the mailbox maximum message size in 
bytes when this value is not specified in a Create Mailbox ($CREMBX) system 
service call. 

Normally the default value is adequate. 

DEFMBXNUMMSG (D) 

DEFMBXNUMMSG enables the default number of messages for mailbox 
creation. 

DEFPRI (D) 

DEFPRI sets the base default priority for processes. 

Normally the default value is adequate. 

DEFQUEPRI (D) 

DEFQUEPRI establishes the default priority for system queues. 

The default value is normally adequate. 

DISK-QUORUM (D) 

The DISK—QUORUM parameter is the name of an optional quorum disk in 
ASCII. ASCII spaces indicate that no quorum disk is being used. 
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DISMOUMSG (D) 

DISMOUMSG controls whether the messages that log volume dismounts 
appear on the operator's terminal and in the operator's log. The default value 
of 0 disables the reporting of these messages. 

DORMANTWAIT (D) 

DORMANTWAIT specifies, in seconds, the amount of time that may elapse 
without a significant event before the system treats a low-priority computable 
process as a DORMANT process for scheduling purposes. (A low-priority 
process is a non-real-time process whose current priority is equal to or less 
than the value specified by the SYSGEN parameter DEFPRI (default=4).) 
After SUSP (suspended) processes, DORMANT processes are the most likely 
candidates for memory reclamation by the swapper. 

DUMPBUG 

DUMPBUG enables or disables the writing of error log buffers and memory 
contents to SYS$SYSTEM:SYSDUMP.DMP when a fatal bugcheck occurs. 
This parameter should be off (0) only when the executive is being debugged. 


EXTRACPU (D) 

EXTRACPU sets the time, in units of 10 milliseconds, allotted to each of a 
process's exit handlers (for each access mode) after the process times out (that 
is, reaches its CPU time limit). 

Normally the default value is adequate. 

FREEGOAL (D,M) 

FREEGOAL establishes the number of pages desired on the free page list 
as the result of a system memory shortage. Memory shortages occur when 
the system drops below the minimum number of pages required on the free 
page list (FREELIM). The value of FREEGOAL must always be greater than 
or equal to the value of FREELIM. 

Normally the computed, installed value is adequate. 

FREELIM (D,M) 

FREELIM sets the minimum number of pages that must be on the free page 
list. The system will write pages from the modified page list, swap out 
working sets, or reduce the size of the working sets to maintain the minimum 
count. 

While the larger free page list generally means less paging I/O, it also means 
less space for the balance set, which tends to result in more swapping I/O. 
You can monitor the size of the free page list, the amount of paging, and the 
amount of swapping with the MONITOR IO command of the Monitor Utility. 

Normally the computed, installed value is adequate. 

GBLPAGES (G,M) 

GBLPAGES sets the number of global page table entries allocated at bootstrap 
time. Each global section requires 1 global page table entry per section page, 
plus 2 entries, with the total rounded up to an even number. Every 128 
global page table entries add 4 bytes to permanently resident memory in the 
form of a system page table entry. 
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The default value is more than adequate for the images normally installed 
as shared in the system startup command procedures. Once the system 
is running and all global sections are created, you can examine the actual 
requirements with the /GLOBAL qualifier of the Install Utility and reduce 
the value of GBLPAGES accordingly. However, the value of this parameter 
should not be set too small, since the page table entries are not expensive 
in terms of permanently resident memory. If you plan to install many user 
images as shared, or if user programs are likely to create many global sections, 
you must increase the value of this parameter. 

Note that as you increase GBLPAGES beyond its default setting, you must 
make an adjustment to SYSMWCNT. For every 128 pages you add to 
GBLPAGES, increase SYSMWCNT by 1. 

GBLPAGFIL 

GBLPAGFIL defines the maximum number of system-wide pages allowed 
for global page-file sections, that is, scratch global sections that can be used 
without being mapped to a file. These global page-file sections can be 
temporary, permanent, system, or group and are allocated from the paging 
file specified in the system process header at bootstrap time. Thus, when you 
allow pages for global page-file sections, be sure to increase the size of the 
paging file accordingly. 

Global page-file sections are created with the Create and Map Section 
($CRMPSC) system service without an explicit disk file. These sections 
are used for the VAX RMS global buffers required for shared files. Users of 
shared files should note that global page-file sections cause both the global 
page table and the default system paging file (PAGEFILE.SYS) to be used. 

If the value of GBLPAGFIL is too small, $CRMPSC issues an error message 
when you attempt to create global page-file sections. 

You need to scratch global sections if you use VAX RMS global buffers. Each 
file using global buffers requires in the system paging file approximately the 
file's bucket size multiplied by the number of global buffers for that file. 

Normally the default value for this parameter is adequate for most systems. 
However, if your site uses VAX RMS global buffering to a significant extent, 
you will probably need to raise the value of GBLPAGFIL. Global buffers are 
enabled with the DCL command SET FILE/GLOBAL_BUFFERS, which is 
described in the VAX/VMS DCL Dictionary. 

You can list the global sections with the /GLOBAL qualifier of the Install 
Utility. The sections used by VAX RMS for global buffers all begin with the 
prefix RMS$, followed by 8 hexadecimal digits representing the longword 
address. 

GBLSECTIONS (G,M) 

GBLSECTIONS sets the number of global section descriptors allocated in the 
system header at bootstrap time. Each global section requires 1 descriptor. 
Each descriptor takes 32 bytes of permanently resident memory. 

The default value is more than adequate for the images normally installed as 
shared in the system startup command procedures. You can, once the system 
is running and all global sections are created, examine the actual requirements 
with the /GLOBAL qualifier of the Install Utility and reduce the value of 
GBLSECTIONS accordingly. However, the value of this parameter should 
not be cut too closely. If you plan to install many user images as shared or if 
user programs are likely to create many global sections, you must increase the 
value of this parameter. 
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If the value of GBLSECTIONS is too small, you receive a message from the 
Install Utility at system startup time or whenever you install images manually. 
Note that too large a value for GBLSECTIONS wastes physical memory. 

GROWLIM (D,M) 

GROWLIM sets the number of pages that the system must have on the free 
page list so that a process can add a page to its working set when it is above 
quota. GROWLIM has no effect if the process is below its working set quota. 
The effect of GROWLIM is to act as a fast shutoff to the working set extent 
mechanism based on the system's free memory. 

IJOBLIM (D) 

IJOBLIM sets the maximum number of interactive jobs that can be on the 
system concurrently. You can control the maximum number of concurrent 
interactive users on the system with the DCL command SET 
LOGINS/INTERACTIVE. 

INTSTKPAGES (D,G,M) 

INTSTKPAGES sets the size of the interrupt stack in pages. Each page on the 
interrupt stack requires a page of permanently resident memory. 

The default value of 2 should be used unless interrupt-stack-not-valid 
exceptions occur. These may be caused by either an unusually large number 
of devices or a driver that requires a very large amount of stack space. 

IRPCOUNT (G,M) 

IRPCOUNT sets the number of preallocated intermediate request packets. 
Each packet requires 160 bytes of permanently resident memory. If 
IRPCOUNT is too large, physical memory is wasted. If IRPCOUNT is 
too small, the system increases its value automatically, as needed, to permit 
proper performance. However, the system cannot increase IRPCOUNT 
beyond the value of IRPCOUNTV. 

Furthermore, there is a minor physical memory penalty for allowing this 
growth. If IRPCOUNT is underconfigured, the penalty is 4 percent of physical 
memory from the configured value to the actual value on the running system. 

You can use the DCL command SHOW MEMORY/POOL/FULL to determine 
IRPCOUNT usage. 

IRPCOUNTV (G) 

IRPCOUNTV establishes the upper limit to which IRPCOUNT can be 
automatically increased by the system. 

If this parameter is set too low, system performance can be adversely affected 
because IRPCOUNTV cannot be used for nonpaged pool requests. 

There is a penalty of 1 percent of physical memory for any unused growth 
space (1 longword for every 3 unused intermediate request packets). 

Normally the computed, installed value is appropriate. 

KFILSTCNT (G) 

KFILSTCNT sets the number of known file list heads. Each active list head 
requires 68 bytes of permanently resident memory. Each extra, never used 
list head requires 4 bytes. The actual known file entries are allocated from 
the paged dynamic pool. 

One known file-list head is required for each set of installed images with a 
different combination of device name, directory name, and file type. 
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Normally the default value is adequate. 

LAMAPREGS (G) 

LAMAPREGS sets the number of UNIBUS map registers allocated to an 
LPA11 driver when the driver is loaded, and limits the registers for the driver 
to that number. A value of 0 permits dynamic allocation of an unlimited 
number of registers. 

LGI_BRK_DISUSER (D) 

LGI_BRK_DISUSER when set, turns on the DISUSER flag in the UAF record 
when an attempted breakin is detected, thus permanently locking out that 
account. The parameter is off by default. You should set the parameter only 
under extreme security watch conditions, since severly restricted service to 
normal users is an inevitable consequence. 

LGI_BRK_LIM (D) 

LGL_BRK_LIM specifies the number of failures that may occur at login time 
before the system will take action against a possible breakin. The count of 
failures applies independently to login attempts by each username, each 
terminal, and each node. Whenever login attempts from any of these sources 
reach the breakin limit specified by LGL_BRK_LIM, the system assumes it is 
under attack and will initiate evasive action as specified by the 
LGL_HID_TIM parameter. 

The default value is usually adequate. 

LGI_BRK_TERM (D) 

LGL_BRK_TERM, when set, causes the terminal name to be part of the 
association string for the terminal mode of breakin detection. When off, 
association is done on username only. LGL_BRK_TERM is set by default. It 
should be cleared if physical terminal names are created dynamically (that is, 
if LAT is installed) and effective breakin detection is desired. 

LGI_BRK_TMO (D) 

LGI_BRK_TMO specifies the number of seconds that a user, terminal, or 
node is permitted to attempt a login before the system assumes that a breakin 
attempt is occurring and takes evasive action. Note that if LGI_BRK_LIM 
is exceeded first, LGL_BRK_TMO may not be reached, and vice versa. The 
evasive action is specified by the LGI_HID_TIM parameter. 

LGI_HID_TIM (D) 

LGL_HID_TIM specifies the number of seconds that evasive action will 
persist following the detection of a possible breakin attempt. The evasive 
action consists of refusing to allow any logins during this period, regardless of 
whether a valid username and password are specified. 

LGI_RETRY_LIM (D) 

LGL_RETRY_LIM specifies the number of retry attempts allowed for users 
attempting to log in over dialup lines. If this parameter is greater than 0, and 
a legitimate user fails to log in correctly because of innocent typing errors, 
the user will probably not automatically lose the carrier. Instead (provided 
that LGL_RETRY_TMO has not elapsed), the user may respond by pressing 
the RETURN key and will be prompted again to enter the username and 
password. However, once this number of attempts has occurred without 
success, the user will automatically lose the carrier. As long as neither 
LGL_BRK_LIM nor LGL_BRK_TMO have elapsed, the user can dial in again 
and reattempt login. 
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LGI—RETRY—TMO (D) 

LGL_RETRY_TMO specifies the number of seconds allowed between login 
retry attempts after each login failure. (Users can initiate login retries by 
pressing the RETURN key.) This parameter is intended for use in conjunction 
with the LGL_RETRY_LIM parameter, to give dialup users a reasonable 
amount of time and number of opportunities to attempt logins before they 
lose the carrier. 

LGI_PWD_TMO (D) 

LGLJPWD—TMO specifies, in seconds, the period of time a user has to enter 
the system password correctly on a terminal on which the system password is 
in effect. 


LNMPHASHTBL (G) 

LNMPHASHTBL sets the size of the process logical name hash table. Logical 
names are hashed using a function of the name length and contents. The 
LNMPHASHTBL parameter determines the number of entries for process- 
private logical names. The recommended setting is the average number of 
process-private logical names. Normally the default value is adequate. 

LNMSHASHTBL (G) 

LNMSHASHTBL sets the size of the system logical name hash table. Logical 
names are hashed using a function of the name length and contents. The 
LNMSHASHTBL parameter determines the number of entries for shareable 
logical names. These names include all names from the system, group, and 
job logical name tables. The recommended setting allows for one to four 
logical names per hash table entry. Normally the default setting is adequate, 
unless your installation has a large number of groups, and unless many 
jobs are active simultaneously. In that case, an increase in the value of 
LNMSHASHTBL to the next higher power of 2 may improve logical name 
translation performance. 

LOCKDIRWT 

LOCKDIRWT determines the portion of lock manager directory that will be 
handled by this system. The default value is usually adequate. 

LOCKIDTBL (M) 

LOCKIDTBL establishes the number of entries in the system Lock ID table, 
which limits the number of locks in the system. There must be one entry 
for each lock in the system; each entry requires four bytes. For simple 
timesharing systems, the default value is adequate. However, if your 
application uses many locks, as in the case of heavy VAX RMS file sharing 
or a database management application, you should increase this parameter. 
(Whenever you change the value of LOCKIDTBL, you should examine the 
value of RESHASHTBL and change it, if necessary.) 

(The VAX/VMS Lock Management Facility is described in the VAX /VMS 
System Services Reference Manual). You can monitor locks with the MONITOR 
LOCK command of the Monitor Utility. 

If you set this parameter value too low, programs can receive the following 
error message: 

'/.SYSTEM-E-NOLOCK ID, no lock id. available 

LOCKIDTBI_MAX (D,G,M) 

LOCKIDTBU-MAX establishes the maximum size of the Lock ID table. 
Normally the default value is adequate. 
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LONGWAIT (D,G,M) 

LONGWAIT defines how much real time (in seconds) must elapse before the 
swapper considers a process to be temporarily idle. This parameter is applied 
to local event flag (LEF) and hibernate (HIB) waits to detect such conditions 
as an inactive terminal or ACP. 

Normally the default value is adequate. 

LRPCOUNT (D) 

LRPCOUNT sets the number of preallocated large request packets. Each 
packet requires an amount of permanently resident memory that is equal 
to the number of bytes specified by the LRPSIZE parameter. (Normally 
LRPSIZE is 576 bytes.) If LRPCOUNT is too large, physical memory 
is wasted. If LRPCOUNT is too small, the system increases its value 
automatically, as needed, to permit the system to perform properly. However, 
the system cannot increase LRPCOUNT beyond the value of LRPCOUNTV. If 
LRPCOUNT is underconfigured, the penalty is 4 percent of physical memory 
from the configured value to the actual value on the running system. 

You can use the DCL command SHOW MEMORY/POOL/FULL to determine 
LRPCOUNT usage. 

LRPCOUNTV (D,G,M) 

LRPCOUNTV establishes the upper limit to which LRPCOUNT can be 
automatically increased by the system. If this parameter is set too low, 
system performance can be adversely affected by preventing the system from 
using this memory allocation mechanism for nonpaged pool requests. There 
is a penalty of 1 percent of physical memory for any unused growth space 
(approximately one longword for every unused large request packet, if the 
default size is used). 

Normally the computed, installed value is appropriate. 

LRPSIZE (D,G,M) 

LRPSIZE is the size (in bytes) of the large request packets. The actual physical 
memory consumed by a large request packet is LRPSIZE plus overhead for 
buffer management. 

Normally the default value is adequate. However, for performance reasons, 
this parameter should be the same as the DECnet NCP parameter BUFFER 
SIZE in the executor database. 

MAXBUF (D) 

MAXBUF sets the maximum size of a buffered I/O transfer (card readers, 
console floppy diskettes, line printers, mailboxes, and terminals). The space 
for a buffered I/O operation is allocated from the permanently resident 
nonpaged dynamic pool. Note that the system adds from 16 to 64 bytes 
(depending on the device driver and the nature of the I/O) to a buffer at 
allocation time for header information. Thus, the largest size transfer possible 
is reduced by this amount. 

MAXPROCESSCNT (G,M) 

MAXPROCESSCNT sets the number of process entry slots allocated at 
bootstrap time. One slot is required for each concurrent process on the 
system. Each slot requires 6 bytes of permanently resident memory. 
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The default value is normally generously configured to allow you to create 
the desired number of processes. If the following message appears, you may 
need to adjust MAXPROCESSCNT: 

'/.SYSTEM-F-NOSLOT, No PCB to create process 

MAXQUEPRI (D) 

MAXQUEPRI establishes the maximum queue priority. The maximum value 
is 255. The minimum is 0, and the default is 4. 

MAXSYSGROUP (D) 

MAXSYSGROUP sets the highest value that a group number can have and 
still be classified as a system UIC group number. Note that the specification 
is not in octal unless preceded by the %0 radix indicator. This parameter is 
normally left at 8 (10 octal). 

MINWSCNT 

MINWSCNT sets the minimum number of fluid pages—that is, pages not 
locked in the working set—required for the execution of a process. This 
value, plus the size of the process header, establishes the minimum working 
set size. 

The value of MINWSCNT must provide sufficient space to execute any 
VAX instruction. Theoretically, the worst-case instruction requires 52 pages; 
however, all VAX/VMS code can run with 20 fluid pages. An insufficient 
value may inhibit system performance or even put a process into an infinite 
loop on some instructions. 

MOUNTMSG (D) 

MOUNTMSG controls whether or not the messages that log volume mounts 
appear on the operator's terminal and in the operator's log. The default 
value of 0 disables the reporting of these messages. (This parameter does not 
control the messages generated by mount assistance requests.) 

M PW_H I LI M IT (G) 

MPW—HILIMIT sets an upper limit for the modified page list. When the list 
accumulates the number of pages specified by this limit, writing of the list 
begins. (The pages that are written are then transferred to the free page list.) 

If MPW—HILIMIT is too low, excessive page faulting can occur from the 
paging file. If it is too high, too many physical pages can be consumed by the 
modified page list. 

If you increase MPW—HILIMIT, you may also need to increase 
MPW—WAITLIMIT. Note that if MPW-WAITLIMIT is less than MPW_ 
HILIMIT, a system deadlock will occur. The values for the two parameters 
are normally equal. 

Normally the default value forf MPW—HILIMIT is adequate. 

MPW—LOLIMIT (G) 

MPW—LOLIMIT sets a lower limit for the modified page list. When writing of 
the list causes the number of pages on the list to drop to or below this limit, 
writing stops. 

MPW—LOLIMIT ensures that a certain number of pages will be available 
on the modified page list for page faults. If the number is too small, the 
caching effectiveness of the modified page list is reduced. If it is too high, 
less memory is available for processes, so that swapping (and paging) may 
increase. 
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Normally the default value is adequate. 

MPW_THRESH (D) 

MPW—THRESH sets a lower bound of pages that must exist on the modified 
page list before the swapper writes this list to acquire free pages. If this 
requirement is met, the swapper will try to write the modified page list rather 
than take pages away from or swap out a process. 

Normally the default value is adequate. 

MPW_WAITLIMIT (D) 

MPW_WAITLIMIT sets the number of pages on the modified page list that 
will cause a process to wait until the next time the modified page writer writes 
the modified list. This parameter limits the rate at which any single process 
can produce modified pages. If this value is less than MPW—HILIMIT, a 
system deadlock will occur. The value for this parameter is normally equal to 
MPW—HILIMIT. 

MPW—WRTCLUSTER (G) 

MPW—WRTCLUSTER sets the number of pages to be written during one I/O 
operation from the modified page list to the paging file or a section file. (The 
actual size of the cluster may be limited by the number of pages available 
for the I/O operation.) This parameter can range in value from 16 to 120, 
in multiples of 8. Each page in the cluster requires 6 bytes of permanently 
resident memory. 

If MPW—WRTCLUSTER is too small, it will take many I/O operations to 
empty the modified page list. If MPW—WRTCLUSTER is too large for the 
speed of the disk that holds the page file, other I/O operations will be held 
up for the modified page list write. 

Normally the default value is adequate. 

MVTIMEOUT (D) 

MVTIMEOUT is the time in seconds that a mount verification attempt will 
continue on a given disk volume. If the mount verification does not recover 
the volume within that time, the I/O operations outstanding to the volume 
will terminate abnormally. 

NJOBLIM (D) 

NJOBLIM establishes the limit for network jobs. The maximum number of 
jobs is 1024. The minimum is 0, and the default is 16. 

NPAGEDYN (G,M) 

NPAGEDYN sets the size of the nonpaged dynamic pool in bytes. This figure 
is rounded down to an integral number of pages. NPAGEDYN establishes the 
initial setting of the nonpaged pool size, but the pool size can be increased 
dynamically. 

Probably the simplest and best approach to take in setting a value for this 
parameter is to initially use the default value, and then monitor the amount of 
space actually used with the DCL command SHOW MEMORY/POOL/FULL. 

There is a minor physical memory penalty for allowing this growth. If 
NPAGEDYN is underconfigured, the penalty is 4 percent of physical memory 
from the configured value to the actual value on the running system. You can 
decrease the value if much space is being wasted, and you should increase it 
if little space is unused. 
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NPAGEVIR (G) 

NPAGEVIR defines the maximum size to which NPAGEDYN can be 
increased. If this value is too small, the system could hang. If NPAGEVIR is 
too large, there is a penalty of 1 percent of physical memory for any unused 
growth space (1 longword for for each 512 bytes of difference between the 
system's actual usage of nonpaged pool and the value of NPAGEVIR). 

PAGEDYN (G,M) 

PAGEDYN sets the size of the paged dynamic pool in bytes. The specified 
value is rounded down to an integral number of pages. Each 512 bytes of 
paged dynamic pool adds 4 bytes of permanently resident memory to the 
system page table; the paged dynamic pool has no other direct memory 
requirements. 

The paged dynamic pool is used to allocate storage for shared logical names, 
resident image headers, known file list entries, and VAX RMS file-sharing 
structures. Substantial amounts of space for the pool can be overallocated 
with little effect on system performance. 

The size of the paged pool can grow dynamically up to the maximum size 
that this parameter specifies. 

Normally the default value is adequate. 

PAGFILCIMT (G) 

PAGFILCNT defines the maximum number of paging files that can be 
installed. 

PAMAXPORT (D) 

PAMAXPORT specifies the maximum port number that the Cl port driver 
polls to discover newly initialized ports, or failed remote ports. 

You can decrease this parameter in order to reduce polling activity if the 
hardware configuration has fewer than 16 ports. For example, if the 
configuration has a total of 5 ports assigned to port numbers 0 through 4, 
then you could set PAMAXPORT to 4. 

If no Cl device is configured on your system, this parameter is ignored. 

PANOPOLL (D) 

PANOPOLL supresses Cl polling for ports. If PANOPOLL is set to 1, a 
VAXcluster member node will not discover that another member node has 
shut down or powered down promptly and will not discover a new member 
node that has booted. This parameter is useful if you want to bring up a 
system that is isolated from the rest of the VAXcluster for checkout purposes. 
Setting PANOPOLL is roughly equivalent to uncabling the system from the 
star coupler. PANOPOLL = 0 (off) is the normal setting and is required if you 
are booting from an HSC, or if your system is joining a VAXcluster. 

If no Cl device is configured on your system, this parameter is ignored. 

PANUMPOLL (D) 

Establishes the number of ports to poll each polling interval. The normal 
setting for PANUMPOLL is 16. The parameter is useful in applications 
sensitive to the amount of contiguous time that VAX/VMS spends at IPL 
8. Reducing PANUMPOLL reduces the amount of time spent at IPL 8 each 
polling interval, while increasing the number of polls needed to discover new 
ports or failed ports. 

If no Cl device is configured on your system, this parameter is ignored. 
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PAPOLLINTERVAL (D) 

PAPOLLINTERVAL specifies in seconds the polling interval the Cl port driver 
uses to poll for a newly booted system, a broken port-to-port virtual circuit, 
or a failed remote port. 

This parameter trades polling overhead against quick response to virtual 
circuit failures. DIGITAL recommends that you use the default value for this 
parameter. 

If no Cl device is configured on your system, this parameter is ignored. 

PAPOOLINTERVAL (D) 

PAPOOLINTERVAL is the interval in seconds after which a Cl or UDA 
port driver's suspended request for message buffer allocation from nonpaged 
pool is awakened to repeat the request. A request is suspended if there is 
insufficent nonpaged pool. 

If no Cl device or UDA 50/52 is configured on your system, this parameter is 
ignored. 

The default value should always be adequate. 

PASANITY (D) 

PASANITY controls whether the port sanity timer is enabled to permit 
remote systems to detect a system that has been hung at IPL 8 or above 
for 100 seconds. This parameter is normally set to 1 and should be set to 0 
only when you are debugging with XDELTA or planning to halt the CPU for 
periods of 100 seconds or more. 

PASANITY is only semi-dynamic. A new value of PASANITY takes effect on 
the next Cl port reinitialization, not immediately. 

If no Cl device is configured on your system, this parameter is ignored. 

PASTDGBUF 

PASTDGBUF is the number of datagram receive buffers to queue initially for 
the Cl port driver's configuration poller: the initial value will be expanded 
during system operation if needed. 

If no Cl device is configured on your system, this parameter is ignored. 
Normally the default value is adequate. 

PASTIMOUT (D) 

PASTIMOUT is the basic interval at which the Cl port driver wakes up to 
perform time-based bookkeeping operations. It is also the period after which 
a start handshake datagram is assumed to have timed out. 

If no Cl device is configured on your system, this parameter is ignored. 

The default value should always be adequate. 

PFCDEFAULT (D) 

During execution of programs, PFCDEFAULT controls the number of image 
pages read from disk per I/O operation when a page fault occurs. The read 
I/O operations can take place from an image file or from the paging file. The 
actual size of the cluster can be less than PFCDEFAULT, depending on the 
size of image sections and the pattern of page references. 
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The value of this parameter should not be less than 16 to ensure adequate 
I/O performance, nor greater than one-fourth the default size of the average 
working set to prevent a single page fault from displacing a major portion 
of a working set. Too large a value for PFCDEFAULT can hurt system 
performance. PFCDEFAULT can be overridden on an image-by-image basis 
with the CLUSTER option of the VAX/VMS Linker. 

Normally the default value is adequate. 

PFRATH (D,M) 

PFRATH specifies the page fault rate above which the limit of a working set 
will be automatically increased. The unit of measure is the number of faults 
per 10 seconds of processor time. At a setting of 120, for example, the system 
will automatically increase the limit of a working set if it is faulting more than 
120 pages per 10 seconds. 

Decreasing the value of this parameter tends to increase the limits of the 
working sets, while increasing its value tends to decrease their limits. 

PFRATL (D,M) 

PFRATL specifies the page fault rate below which the limit of a working 
set is automatically decreased. The unit of measure is the number of faults 
per 10 seconds of processor time. At a setting of 1, for example, the system 
automatically decreases the limit of a working set if it is faulting less than 1 
page every 10 seconds. 

Increasing the value of this parameter tends to decrease the limits of the 
working sets, while decreasing its value tends to increase their limits. 

PQI_DASTLM (D,G) 

PQL—DASTLM sets the default limit on the number of pending ASTs for a 
process created by the Create Process (SCREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_DBIOLM (D,G) 

PQL—DBIOLM sets the default buffered I/O count limit for the number 
of outstanding buffered I/O operations permitted to a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_DBYTLM (D,G) 

PQU_DBYTLM sets the default buffered I/O byte count limit for the amount 
of buffered space available to a process created by the Create Process 
($CREPRC) system service or the DCL command RUN (Process). 

Normally the default value is adequate. 

PQI_DCPULM (D,G) 

PQl^DCPULM sets the default CPU time limit for a process created by 
the Create Process (SCREPRC) system service or the DCL command RUN 
(Process). PQL—DCPULM specifies the time limit in increments of 10 
milliseconds. 

The default value of 0 imposes no limit on CPU time usage and is typically 
the correct value for this parameter. 
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PQI_DDIOLM (D,G) 

PQL—DDIOLM sets the default direct I/O limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_DENQLM (D,G) 

PQL—DENQLM sets the default enqueue limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_DFILLM (D,G) 

PQL—DFILLM sets the default open file limit for a process created by the 
Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_DPGFLQUOTA (D,G) 

PQL—DPGFLQUOTA sets the default paging file quota for a process created 
by the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQLDjJqUOTA (D) 

PQL—DJJQUOTA sets the default job table byte count quota for a process 
created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). PQL_DJJQUOTA specifies the number of bytes 
of paged pool allocated to the job table. Normally the default values is 
adequate, unless a large number of job logical names or temporary mailboxes 
are used. 

T 

PQI—MJAQUOTA (D) 

PQL—MJJQUOTA sets the minimum job table byte count quota for a 
process created by the Create Process ($CREPRC) system service or the 
DCL command RUN (Process). Normally the default value is adequate. 

PQI_DPRCLM (D,G) 

PQL—DPRCLM sets the default subprocess limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQL.DTQELM (D,G) 

PQL—DTQELM sets the default number of timer queue entries for a process 
created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_DWSDEFAULT (G) 

PQL_DWSDEFAULT sets the default working set size for a process created 
by the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 
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Normally the default value is adequate. 

PQI_DWSEXTENT (D,G) 

PQL—DWSEXTENT sets the default working set extent for a process created 
by the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_DWSQUOTA (D,G) 

PQL—DWSQUOTA sets the default working set quota for a process created 
by the Create Process (SCREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_MASTLM (D,G) 

PQU-MASTLM sets a default limit on the minimum number of pending ASTs 
for a process created by the Create Process ($CREPRC) system service or the 
DCL command RUN (Process). 

Normally the default value is adequate. 

PQI_MBIOLM (D,G) 

PQL—MBIOLM sets the minimum buffered I/O limit for a process created 
by the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_MBYTLM (D,G) 

PQL—MBYTLM sets the minimum buffered I/O byte limit for a process 
created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_MCPULM (D,G) 

PQL—MCPULM sets the minimum CPU time limit in increments of 10 
milliseconds for a process created by the Create Process ($CREPRC) system 
service or the DCL command RUN (Process). 

Normally the default value is adequate. 

PQI_MDIOLM (D,G) 

PQL—MDIOLM sets the minimum direct I/O limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_MENQLM (D,G) 

PQU-MENQLM sets the default limit on the minimum number of locks 
that can be queued at one time by a process created by the Create Process 
(SCREPRC) system service or the DCL command RUN (Process). 

Normally the default value is adequate. 
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PQI_MFILLM (D,G) 

PQL—MFILLM sets the minimum open file limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_MPGFLQUOTA (0,0 

PQU-MPGFLQUOTA sets the minimum paging file quota for a process 
created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_MPRCLM (D,G) 

PQL—MPRCLM sets the minimum subprocess limit for a process created by 
the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PQI_MTQELM (D,G) 

PQL—MTQELM sets the minimum number of timer queue entries for a 
process created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_MWSDEFAULT (G) 

PQL—MWSDEFAULT sets the minimum default working set size for a 
process created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_MWSEXTENT (D,G) 

PQL.JMWSEXTENT sets the minimum working set extent for a process 
created by the Create Process ($CREPRC) system service or the DCL 
command RUN (Process). 

Normally the default value is adequate. 

PQI_MWSQUOTA (D,G) 

PQL—MWSQUOTA sets the minimum working set quota for a process created 
by the Create Process ($CREPRC) system service or the DCL command RUN 
(Process). 

Normally the default value is adequate. 

PRCPOLINTERVAL (D) 

PRCPOLINTERVAL specifies in seconds the polling interval used to look for 
Systems Communications Services (SCS) applications, such as the Connection 
Manager and Mass Storage Control Protocol (MSCP) disks, on other nodes. 
All discovered nodes are polled each interval. 

This parameter trades polling overhead against quick recognition of new 
systems or servers as they appear. 

Normally the default value is adequate. 
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PROCSECTCNT (G) 

PROCSECTCNT sets the number of section descriptors that a process can 
contain. Each section descriptor increases the fixed portion of the process 
header by 32 bytes. 

You should set a value greater than the maximum number of image sections 
in any section to be run, as indicated by the linkage memory allocation map 
for the image. 

Normally the default value is adequate. 

QDSKINTERVAL 

QDSKINTERVAL establishes the disk quorum polling interval in seconds. 
Normally the default value is adequate. 

QDSKVOTES 

QDSKVOTES specifies the number of votes contributed by a quorum disk in 
a VAXcluster. 

Normally the default value is adequate. 

QUANTUM (D,M) 

QUANTUM defines 

• Processor time—Maximum amount of processor time a process can receive 
before control passes to another process of equal priority that is ready to 
compute 

• Balance set residency—Minimum amount of service a compute-state 
process must receive before being swapped out to secondary storage 

Normally the default value is adequate. 

QUORUM 

QUORUM establishes the quorum for an operative cluster. 

Normally the default value is adequate. 

REALTIME_SPTS (D,G,M) 

REALTIME_SPTS reserves a number of system page table entries for 
mapping connect-to-interrupt processes into system space. This value should 
normally remain at the default (0) in an environment that is not real-time. 
Where connect-to-interrupt processes do use the system, this value should 
represent the maximum number of pages that all concurrent connect-to- 
interrupt processes must map into system space. See the VAX/VMS Run-Time 
Library Routines Reference Manual for details. 

RECNXINTERVAL (D) 

RECNXINTERVAL establishes the polling interval (in seconds) during which 
to attempt reconnection to a remote system. 

The default value is normally adequate. 

RESHASHTBL (M) 

RESHASHTBL defines the number of entries in the lock management resource 
name hash table. Each entry requires 4 bytes. As a general guideline, there 
should be 1 resource hash table entry for every 4 locks in the system. Thus, 
RESHASHTBL should be one-quarter the value of LOCKIDTBL, rounded up 
to the closest power of 2. 
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The default value is normally adequate. 

RJOBLIM (D) 

RJOBLIM defines the maximum number of remote terminals allowed in the 
system at any one time. 

The default value is normally adequate. 

RMS—DFNBC (D) 

RMS—DFNBC specifies a default block count for network access to remote, 
sequential, indexed sequential, and relative files. 

The network block count value represents the number of blocks that RMS 
is prepared to allocate for the I/O buffers used to transmit and receive 
data. The buffer size used for remote file access, however, is the result of a 
negotiation between VAX RMS and the remote File Access Listener (FAL). 
The buffer size chosen is the smaller of the two sizes presented. 

Thus, RMS—DFNBC places an upper limit on the network buffer size that 
will be used. It also places an upper limit on the largest record that may be 
transferred to or from a remote file. In other words, the largest record that 
can be transferred must be less than or equal to RMS—DFNBC multiplied by 
512 bytes. 

Normally the default value is adequate. 

RMS—DFMBFHSH (D) 

RMS—DFMBFHSH establishes the hashed multibuffer count. Normally the 
default value is adequate. 

RMS—DFMBFIDX (D) 

RMS—DFMBFIDX establishes the default VAX RMS multibuffer count for 
indexed sequential disk operations. This value defines the number of I/O 
buffers that VAX RMS allocates for each indexed file. For sequential access, 
a larger number that allows some of the index buckets to remain in memory 
can improve performance. 

Normally the default value is adequate. 

RMS—DFMBFREL (D) 

RMS—DFMBFREL establishes the default VAX RMS multibuffer count for 
relative disk operations. This value defines the number of I/O buffers that 
VAX RMS allocates for each relative file. 

Normally the default value is adequate. 

RMS—DFMBFSDK (D) 

RMS—DFMBFSDK establishes the default VAX RMS multibuffer count for 
sequential disk operations. This value defines the number of I/O buffers that 
VAX RMS allocates for sequential disk files. 

Normally the default value is adequate. However, if read/ahead or 
write/behind operations are used, a larger number will improve performance. 

RMS—DFMBFSMT (D) 

RMS—DFMBFSMT establishes the default VAX RMS multibuffer count for 
magnetic tape operations. This value defines the number of I/O buffers that 
VAX RMS allocates for magnetic tape files. 

Normally the default value is adequate. 
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RMS—DFMBFSUR (D) 

RMS—DFMBFSUR establishes the default multibuffer count for unit record 
devices. 

Normally the default value is adequate. 

RMS_DFNBC (D) 

RMS—DFNBC specifies the default network file transfer block count, that is, 
the default message size in disk blocks to be used when performing DECnet 
file transfer operations. 

Normally the default value is adequate. 

RMS_EXTEND_SIZE (D) 

RMS_EXTEND_SIZE specifies the number of blocks by which files are 
extended as they are written. This number should be chosen to balance 
the amount of extra disk space wasted at the ends of each file against the 
performance improvement provided by making large extents infrequently. 
When small disk quotas are used, a small number such as the disk cluster size 
should be specified to prevent the user's disk quota from being consumed. If 
the value of 0 is used, VAX RMS will allocate large extents and truncate the 
file back to its actual usage when it closes. 

Normally the default value is adequate. 

RMS—FILEPROT 

RMS—FILEPROT determines the default file protection for system processes 
such as those that create the error log, operator log, and job controller. It also 
determines default file protection for processes created by the job controller; 
that is, all interactive and batch processes. 

Note that since a process always inherits its default file protection from its 
creator process, RMS—FILEPROT determines default file protection only for 
users who do not execute the DCL command SET PROTECTION/DEFAULT 
in their login command procedure or during an interactive session. 

The protection is expressed as a mask (see the VAX/VMS DCL Dictionary 
for more information on specifying protection masks). By default, the mask 
is 64000 (decimal) or FA00 (hexadecimal), which represents the following 
protection: 

(S:RWED,0:RWED,G:RE,W:) 

RMS—GBLBUFQUO (D) 

RMS—GBLBUFQUO specifies the number of global buffers that may be 
allocated on the system at any one time. 

Normally the default value is adequate. 

RMS_PROLOGUE (D) 

RMS—PROLOGUE specifies the default prologue VAX RMS uses to create 
indexed files. The default value 0 specifies that VAX RMS should determine 
the prologue based on characteristics of the file. 2 specifies Prologue 2 
or Prologue 1, and 3 specifies Prologue 3. The VAX RMS prologues are 
described in the VAX Record Management Services Reference Manual. 

SAVEDUMP 

SAVEDUMP specifies whether, if the dump file is saved in the page file, the 
page file should be saved until the dump file is analyzed. The default value 


SGN-78 




SYSGEN 

Supplemental SYSGEN Information 


0 specifies that the page file should not be saved. A value of 1 specifies that 
the file should be saved. 

SCSBUFFCNT (G) 

SCSBUFFCNT is the number of Cl buffer descriptors configured for all Cl 
ports on the system. If no Cl device is configured on your system, this 
parameter is ignored. 

SCSCONNCNT (G) 

SCSCONNCNT is the initial number of SCS connections that are configured 
for use by all system applications, including the one used by Directory Service 
Listen. The initial number will be expanded by the system if needed. 

If no Cl device or UDA 50/52 is configured on your system, this parameter is 
ignored. 

The default value is adequate for all CI/UDA hardware combinations 
available with VAX/VMS Version 4.0. 

SCSFLOWCUSH (D) 

SCSFLOWCUSH is an SCS flow control parameter for sequenced messages. 
For each connection, SCS tracks the number of receive buffers available and 
communicates the number to the SCS at the remote end of the connection. 
However, SCS does not need to do this for each new receive buffer added. 
Instead, SCS notifies the remote SCS of new receive buffers if the number 
already communicated to the remote SCS falls as low as the value of 
SCSFLOWCUSH. 

If no Cl device is configured on your system, this parameter is ignored. 
Normally the default value is adequate. 

SCSMAXDG (G) 

SCSMAXDG is the maximum number of bytes of application data in one 
datagram. The amount of physical memory consumed by one datagram 
packet is SCSMAXDG plus overhead for buffer management. 

DECnet is a primary user of SCS datagrams. For performance reasons, 
SCSMAXDG should be set to the same value (up to a maximum of 985) as 
the DECnet NCP parameter BUFFER SIZE in the executor database. (Note 
the the maximum value for NCP parameter BUFFER SIZE is greater than the 
maximum value for SCSMAXDG.) 

If no Cl device is configured on your system, this parameter is ignored. 

SCSMAXMSG (G) 

SCSMAXMSG is the maximum number of bytes of application data in one 
message. 

If no Cl device is configured on your system, this parameter is ignored. 

Do not change the default value. 

SCSNODE (G) 

SCSNODE specifies the SCS system name. It should be the same as the 
DECnet node name (limited to six characters), since the name must be unique 
among all systems in the VAXcluster. 

SCSRESPCNT (G) 

SCSRESPCNT is the total number of response descriptor table entries 
(RDTEs) configured for use by all system applications. 
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If no Cl device or UDA 50/52 is configured on your system, this parameter is 
ignored. 

Normally the default value is adequate. 

SCSSYSTEMID (G) 

SCSSYSTEMID specifies the lower-order 32 bits of the 48-bit system 
identification number. It is the unique identifier of each system and is 
calculated as follows: 

(DECnet area number * 1024) + DECnet-VAX node number. 

For example, if the DECnet address is 2.211, then SCSSYSTEMID should be 
set to (2 * 1024) + 211. 

SCSSYSTEMIDH (G) 

SCSSYSTEMIDH specifies the high-order 16 bits of the 48-bit system 
identification number and must be 0. 

SETTIME 

SETTIME enables or disables solicitation of the time of day each time the 
system is booted. This parameter should normally be off (0), so that the 
system sets the time of day at boot time to the value of the processor time- 
of-day register. You can reset the time after the system is up with the DCL 
command SET TIME (see the VAX/VMS DCL Dictionary). 

SPTREQ 

SPTREQ sets the number of system page table (SPT) entries required for 
mapping the following components: 

Executive image 
VAX RMS image 
SYSMSG.EXE file 
Multiport memory structures 
Each MASSBUS adapter 
Each UNIBUS adapter 
Each DR32 adapter 

The number of system page table entries required for all other purposes is 
automatically computed and added to the value of SPTREQ to yield the actual 
size of the system page table. 

Normally the default value is adequate. 

SRPCOUNT (M) 

SRPCOUNT sets the number of preallocated small request packets. Each 
packet requires 96 bytes of permanently resident memory. If SRPCOUNT is 
too large, physical memory is wasted. If SRPCOUNT is too small, the system 
increases its value automatically, as needed, to permit proper performance. 

However, the system cannot increase SRPCOUNT beyond the value of 
SRPCOUNTV. Furthermore, there is a minor physical memory penalty for 
allowing this growth. If SRPCOUNT is underconfigured, the penalty is 4 
percent of physical memory from the configured value to the actual value on 
the running system. 

You can use the DCL command SHOW MEMORY/POOL/FULL to determine 
SRPCOUNT usage. 
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SRPCOUNTV 

SRPCOUNTV establishes the upper limit to which SRPCOUNT can be 
increased. 

If this parameter is set too low, system performance can be adversely affected 
by preventing the system from using this memory allocation mechanism for 
nonpaged pool requests. If SRPCOUNTV is set too high, there is a penalty of 
1 percent of physical memory for any unused growth space (1 longword for 
every 5 unused small request packets if the default size is used). 

Normally the computed, installed value is appropriate. 

STARTUP-PI-8 

STARTUP_P1 specifies that a minimum sequence of system startup 
procedures be performed. STARTUP—P2 controls whether verification is 
set during the execution of a startup procedure. STARTUP—P3-P8 are not yet 
implemented. 

SWPFILCNT 

SWPFILCNT defines the maximum number of swapping files that can be 
installed. 

SWPOUTPGCNT (D) 

SWPOUTPGCNT defines the process size as the number of pages to which 
the swapper should attempt to reduce a process before swapping it out. 

The pages taken from the process are placed into the paging system. This 
parameter allows the swapper an alternative mechanism before actually 
performing swaps. 

Normally the default value is adequate. 

SYSMWCNT (G,M) 

SYSMWCNT sets the quota for the size of the system working set, which 
contains the pageable portions of the system, the paged dynamic pool, VAX 
RMS, and the resident portion of the system message file. 

While a high value takes space away from user working sets, a low value may 
seriously impair system performance. Appropriate values vary depending on 
the level of system use. When the system is running at full load, check the 
rate of system faults with the MONITOR PAGE command of the Monitor 
Utility. An average system page fault rate of between 0 and 3 page faults 
per second is desirable. If the system page fault rate is high, and especially if 
the system seems to be slow, you should increase the value of SYSMWCNT. 
However, do not set this parameter so high that system page faulting never 
occurs. 

TAILORED 

TAILORED specifies whether the system is "tailored" —that is, whether it has 
a library disk. 

TIMEPROMPTWAIT 

TIMEPROMPTWAIT defines the number of seconds that a VAX processor 
should wait for the time and date to be entered when a system boot occurs, 
if the processor's time-of-year clock does not contain a valid time. (The time 
unit of micro-fortnights is approximated as seconds in the implementation.) 

If the time specified by TIMEPROMPTWAIT elapses, the system continues 
the boot operation, and the date and time are set to the last recorded time 
that the system booted. For a VAX-11/730, which does not have a battery 
back-up clock, the system time must be supplied whenever power fails. 
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Note: DIGITAL recommends that you set the system time correctly before 

allowing the system to run, so that all functions employing time-stamping 
(such as the operator log, the error log, accounting records, file creation 
dates, and file expiration dates) will contain correct time values. 

• If TIMEPROMPTWAIT is 0, no prompt or wait occurs; the system boots 
immediately, using the time of the last boot as the system time. 

• If TIMEPROMPTWAIT is a positive number less than 32768, one 
prompt is issued and the value dictates how many seconds you can 
take to respond with a time. If you do not provide a time before 
TIMEPROMPTWAIT elapses, the system boots, using the time of the 
last boot as the system time. 

• If TIMEPROMPTWAIT is a number in the range of 32768 through 65535, 
the prompt for the time is issued at intervals starting with 2 and doubling 
until 256 seconds is reached. If no response is received, the prompts 
restart, with the 2-second interval. This prompting process repeats 
indefinitely, until you specify a time. 


TTY_ALT ALARM 

TTY_ALTALARM sets the size of the alternate type-ahead buffer alarm. This 
value indicates at what point an XOFF should be sent to terminals that use 
the alternate type-ahead buffers with the size specified by the 
TTY_ALTYPAHD parameter. 

Normally the default value is adequate. 

TTY_ALTYPAHD 

TTY_ALTYPAHD sets the size of the alternate type-ahead buffer. Use this 
parameter to allow the block mode terminals and communications lines to 
operate more efficiently. 

Normally the default value is adequate. 

TTY_AUTOCHAR 

TTY_AUTOCHAR sets the character the terminal driver echoes when 

autobaud completes successfully. 

TTY_BUF 

TTY—BUF sets the default line width for terminals. 

TTY_CLASSNAME 

TTY_CLASSNAME provides the 2-character prefix for the terminal class 
driver name that is required when booting. Changing the prefix can be useful 
when debugging a new terminal driver. 

TTY_DEFCHAR 

TTY—DEFCHAR sets the default characteristics for terminals, using a code 
derived by summing the following hexadecimal values: 
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Characteristic 

Value 

Function 

PASSALL 1 

1 

Passall mode 

NOECHO 

2 

Noecho mode 

NOTYPEAHEAD 1 

4 

No type-ahead buffer 

ESCAPE 

8 

Escape sequence processing 

HOSTSYNC 

10 

Host can send XON/XOFF 

TTSYNC 

20 

Terminal can send XON/XOFF 

LOWERCASE 

80 

Lowercase 

TAB 

100 

Mechanical tabs 

WRAP 

200 

Wraparound at end of line 

CRFILL 1 

400 

Perform carriage return fill 

LFFILL 1 

800 

Perform line feed fill 

SCOPE 

1000 

Terminal is a scope 

HOLD-SCREEN 

4000 

VT52 holdscreen feature 

EIGHT-BIT 

8000 

Eight-bit terminal 

MBXDSABL 

10000 

Disable mailbox 

NOBROADCAST 

20000 

Prohibit broadcast 

READSYNC 

40000 

XON/XOFF on reads 

FORM 

80000 

Mechanical form feeds 

HALFDUP 

100000 

Set for half-duplex operation 

MODEM 

200000 

Set for modem signals 

^o not set this characteristic as the default in TTY_DEFCHAR. 


Where a condition is false, the value is 0. 

The upper byte is the page length. The default characteristics are 24 lines 
per page, terminal synchronization, wraparound, lowercase, scope, and 
half-duplex. 

TTY_DEFCHAR2 

TTY—DEFCHAR2 sets a second longword of default terminal characteristics. 
The default characteristics are represented as a code that is derived by 
summing the following hexadecimal values: 


Characteristic 

Value 

Function 

LOCALECHO 

1 

Enable local echo terminal logic; use with 
the TTY—DEFCHAR NOECHO characteristic 

AUTOBAUD 

2 

Enable autobaud detection 

HANGUP 

4 

Hang up on logout 

MODHANGUP 

8 

Allow modification of HANGUP without 
privileges 

BRDCSTMBX 

10 

Allow sending of broadcasts to mailboxes 

XON 

20 

(No effect in this parameter) 
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Characteristic 

Value 

Function 

DMA 

40 

(No effect in this parameter) 

ALTYPEAHD 

80 

Use the alternate type-ahead parameters 

SETSPEED 

100 

Clear to allow setting of speed without 
privileges 

EDITING 

1000 

Line editing allowed 

INSERT 

2000 

Sets default mode for insert 

FALLBACK 

4000 

Output transformed from 8-bit 
multinational character set to 7-bit ASCII 

DIALUP 

8000 

Terminal is a dialup line 

SECURE 

10000 

Guarantees that no process is connected 
to terminal after BREAK key is pressed 

DISCONNECT 

20000 

Allows terminal disconnect when a hangup 
occurs 

PASTHRU 

40000 

Terminal is in PASTHRU mode 

SYSPWD 

80000 

Login with system password only 

SIXEL 

100000 

Sixel graphics 

DRCS 

200000 

Terminal supports loadable character fonts 

PRINTER 

400000 

Terminal has printer port 

APP_KEYPAD 

800000 

Notifies application programs of state to 
set keypad on exit 

ANSI—CRT 

1000000 

Terminal conforms to ANSI CRT 
programming standards 

REGIS 

2000000 

Terminal has REGIS CRT capabilities 

BLOCK_MODE 

4000000 

Block mode terminal 

ADVANCED-VIDEO 

8000000 

Terminal has advanced video 

EDIT 

10000000 

Terminal has local edit capabilities 

DECCRT 

20000000 

Terminal is a DIGITAL CRT 


The defaults are AUTOBAUD and EDITING. 

TTY—DIALTYPE 

TTY_DIALTYPE provides flag bits for dialups. Bit 0 is 1 for United Kingdom 
dialups and 0 for all others. Bit 1 controls the modem protocol used. The 
remaining bits are reserved for future use. See the VAX/VMS I/O User's 
Reference Manual: Part I for more information on the flag bits. 

TTY_DMASIZE (D) 

TTY—DMASIZE specifies the number of characters in the output buffer below 
which character transfers are performed, and above which DMA transfers 
occur, provided the controller is capable of DMA I/O. 

TTY_OWNER 

TTY_OWNER specifies the owner UIC against which terminal protection 
is set. The specification must represent the value of a standard 32-bit UIC 
with the group number in the high-order word and the member number in 
the low-order word. You should normally set TTY—OWNER to a value of 
hexadecimal 10004, which is UIC [1,4]. 
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TTY—PARITY 

TTY_PARITY sets terminal default parity. 

TTY_PROT 

TTY_PROT sets the default protection for all terminals in relation to the UIC 
specified for the TTY_OWNER parameter. The specification must represent 
the value of a standard 16-bit protection mask as described in the VAX/VMS 
DCL Dictionary. However, only read bits are meaningful. When a read bit is 
on, that category of user is prohibited from allocating terminals. 

The default (FFFO) provides for system access only on terminals. You can 
change protection on a per-terminal basis with the DCL command SET 
PROTECTION/DEVICE, to permit user allocation of remote and application 
terminals. 

Note that this protection does not prevent logging in on the terminal; it only 
prevents allocation of the terminal by another process. 

TTY_RSPEED 

TTY_RSPEED defines the receive speed for terminals. If TTY_RSPEED is 0, 
TTY_SPEED controls both the transmit and the receive speed. This parameter 
is only applicable for controllers that support split speed operations, such as 
the DZ-32 and the DMF-32. 

TTY-SC AN DELTA 

TTY_SCANDELTA sets the interval for polling terminals for dialup and 
hang-up events. Shorter intervals use more processor time; longer intervals 
may result in missing a hangup event. 

TTY_S I LOTI M E 

TTY—SILOTIME defines the interval at which the DMF-32 hardware polls 
the input silo for received characters. The DMF-32 asynchronous terminal 
controller can delay the generation of a single input interrupt until multiple 
characters have accumulated in the input silo. TTY_SILOTIME specifies the 
number of milliseconds that the characters are allowed to accumulate prior to 
the generation of an input interrupt by the hardware. 

Normally the default value is adequate. 

TTY_SPEED 

TTY_SPEED sets the system-wide default speed for terminals. Low byte is 
transmit speed, and high byte is receive speed. If high byte is set to 0, receive 
speed is identical to transmit speed. Baud rates are defined by the $TTDEF 
macro. 

TTY_TIMEOUT 

TTY—TIMEOUT sets the number of seconds before a process associated with 
a disconnected terminal is deleted. Normally the default value (300 seconds) 
is adequate. 

TTY—TYPAH DSZ 

TTY—TYPAHDSZ sets the size of the terminal type-ahead buffer. Normally 
the default value is adequate. 

UAFALTERNATE (D,G,M) 

UAFALTERNATE enables or disables the assignment of SYSUAF as the 
logical name for SYSUAFALT, causing all references to the user authorization 
file (SYSUAF) to be translated to SYS$SYSTEM:SYSUAFALT. Use of the 
normal user authorization file (SYS$SYSTEM:SYSUAF) can be restored by 
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deassigning the system logical name SYSUAF. This parameter should be set 
on (1) only when the system is being used by a restricted set of users. You 
must create a user authorization file named SYSUAF ALT prior to setting 
UAFALTERNATE to 1. 

UDABURSTRATE (G) 

UDABURSTRATE specifies the maximum number of longwords that the 
UDA50 or LESI controller will transfer on the UNIBUS per DMA transfer. 

Normally the default value is adequate. 

USERD1 (D) 

USERD1 is a dynamic parameter that is reserved for definition at the user's 
site. The reserved longword is referenced by the symbol SGN$GL_USERD1 
in the module SYS$SYSTEM:SYS.STB. 

USERD2 (D) 

USERD2 is a dynamic parameter that is reserved for definition at the user's 
site. The reserved longword is referenced by the symbol SGN$GL__USERD2 
in the module SYS$SYSTEM:SYS.STB. 

USER3 

USER3 is a parameter that is reserved for definition at the user's site. The 
reserved longword is referenced by the symbol SGN$GL_USER3 in the 
module SYS$SYSTEM:SYS.STB. 

USER4 

USER4 is a parameter that is reserved for definition at the user's site. The 
reserved longword is referenced by the symbol SGN$GL_USER4. 

VAXCLUSTER 

VAXCLUSTER controls loading of the cluster code. Specify one of the 
following: 

0: Never load 

1: Load if SCSLOA is being loaded 
2: Always load (and also load SCSLOA) 

The default value is 1. 

VIRTUALPAGECNT (G,M) 

VIRTU ALP AGECNT sets the maximum number of virtual pages that can 
be mapped for any one process. Every 128 virtual pages require 4 bytes of 
permanently resident memory in the system page table (as discussed under 
the BALSETCNT parameter). A program is allowed to divide its virtual space 
between the P0 and PI tables in any proportion, except that the PI table 
must be large enough to map 320 pages. 

When the System Dump Analyzer is used, you must ensure that the value of 
VIRTUALPAGECNT is at least the size of the dump file plus approximately 
3000 pages. 

Normally the computed, installed value is adequate. 

VOTES 

VOTES establishes the number of votes a VAXcluster member system 
contributes to a quorum. 
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WSDEC (D,M) 

WSDEC specifies the number of pages by which the limit of a working set 
is automatically decreased at each adjustment interval (which is quantum 
end). At a setting of 35, for example, the system will decrease the limit of a 
working set by 35 pages each time a decrease is required. 

Increasing the value of this parameter tends to increase the speed with which 
working set limits are decreased when the need arises. 

WSINC (D,M) 

WSINC specifies the number of pages by which the limit of a working set 
is automatically increased at each adjustment interval (which is quantum 
end). At a setting of 150, for example, the system will increase the limit of a 
working set by 150 pages each time an increase is required. 

Decreasing the value of this parameter tends to reduce the speed with which 
working set limits are increased when the need arises. Normally, you should 
keep this parameter at a high value because a rapid increase in limit is often 
critical to performance. 

A value of 0 for WSINC disables the automatic adjustment of working set 
limits for all processes. Limits stay at their base values. You can disable the 
automatic adjustment of working set limits on a per-process basis by using 
the DCL command SET WORKING-SET. 

WSMAX (G,M) 

WSMAX sets the maximum number of pages on a system-wide basis for any 
working set. The value of WSMAX also affects the allocation of permanently 
resident memory for the swapper map and system page table (and for this 
reason should not be set at an arbitrarily high number): 

• Swapper map—4 bytes for each page of WSMAX 

• System page table—4 bytes for each 128 pages of WSMAX, times 
BALSETCNT 

Generally, you should use as a value for WSMAX the size of the largest 
working set needed on your system. The default value is appropriate for 
normal time-sharing operations, while significantly larger values should be 
used only for programs with very large virtual address spaces, to reduce page 
faulting. 

XFMAXRATE (D) 

XFMAXRATE limits the data transfer rate that can be set for DR32 devices. 
On some hardware configurations (especially those without interleaved 
memory), a high DR32 transfer rate could cause a machine check (CPU 
timeout). The VAX/VMS I/O User's Reference Manual: Part I describes how 
to encode this parameter. 
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